Back to Warranty API

Transfer Ownership

POST /api/v1/warranty/{hin}/transfer

Transfers ownership of a warranty to a new contact. The previous owner is automatically recorded in the ownership history.

Path Parameters

Parameter Type Required Description
hin string Yes Hull ID Number (12 alphanumeric chars)

Request Body

Field Type Required Description
contact object Yes Full contact object for the new owner (see Contact Object above)
registration_date string No New registration date (YYYY-MM-DD)
purchase_date string No New purchase date (YYYY-MM-DD)
transfer_notes string No Notes about the transfer

Example Request

curl -X POST https://api.marquatica.com/api/v1/warranty/ABC12345DE78/transfer \
  -H "Authorization: Bearer <Token>" \
  -H "Content-Type: application/json" \
  -d '{
    "contact": {
      "first_name": "Jane",
      "last_name": "Smith",
      "email": "jane@example.com",
      "phone": "555-222-3333",
      "address": "456 Harbor Drive",
      "zipcode": "33139",
      "city": "Miami Beach",
      "state": "FL",
      "country_code": "US"
    },
    "registration_date": "2026-02-01",
    "purchase_date": "2026-01-28",
    "transfer_notes": "Second owner purchase via dealer"
  }'

Success Response

{
  "success": true,
  "status": 200,
  "data": {
    "hin": "ABC12345DE78",
    "brand_id": 1,
    "brand_name": "Brand XYZ",
    "model": "Model XYZ",
    "model_code": null,
    "model_year": "2025",
    "is_used": false,
    "warranty_start_date": "2025-01-15",
    "purchase_date": "2026-02-01",
    "registration_date": "2026-02-01",
    "warranty_duration_months": null,
    "warranty_end_date": null,
    "coverage_type": "limited",
    "warranty_status": "active",
    "warranty_notes": null,
    "order_number": null,
    "external_order_number": null,
    "warranty_external_id": null,
    "contact": {
      "contact_id": 58,
      "first_name": "Jane",
      "last_name": "Smith",
      "email": "jane@example.com",
      "phone": "555-222-3333",
      "address": "456 Harbor Drive",
      "zipcode": "33139",
      "city": "Miami Beach",
      "state": "FL",
      "country_code": "US"
    }
  },
  "meta": {
    "timestamp": "2026-02-01T10:00:00.000000Z",
    "version": "0.1.2"
  }
}
Try It Out
cURL Preview
POST https://api.marquatica.com/api/v1/warranty/{hin}/transfer
Base URL
Authorization
Bearer Token
Path Parameters
* hin required
Body Parameters
* contact.first_name required
* contact.last_name required
* contact.email required
* contact.phone required
* contact.zipcode required
registration_date optional
purchase_date optional
transfer_notes optional
contact.address optional
contact.city optional
contact.state optional
contact.country_code optional
Response
Send a request to see the response
On this page