Back to Warranty API

Update Warranty

PATCH /api/v1/warranty/{hin}

Updates an existing warranty. Only include the fields you want to change. The contact field supports nested partial updates.

Path Parameters

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

Updateable Fields

Field Type Required Description
warranty_duration_months integer No Updated duration in months
coverage_type string No full, limited, structural, hull-only, or other
warranty_status string No active, expired, or voided
warranty_notes string No Additional notes
contact object No Partial contact update (only include fields to change)

Example Request

curl -X PATCH https://api.marquatica.com/api/v1/warranty/ABC12345DE78 \
  -H "Authorization: Bearer <Token>" \
  -H "Content-Type: application/json" \
  -d '{
    "warranty_duration_months": 48,
    "coverage_type": "full",
    "warranty_notes": "Extended warranty applied",
    "contact": {
      "phone": "555-999-8888"
    }
  }'

Success Response

{
  "success": true,
  "status": 200,
  "data": {
    "hin": "ABC12345DE78",
    "brand_id": 1,
    "brand_name": "Brand XYZ",
    "model": "Model XYZ",
    "model_code": "MXYZ",
    "model_year": "2025",
    "is_used": false,
    "warranty_start_date": "2025-01-15",
    "purchase_date": "2025-01-10",
    "registration_date": "2025-01-15",
    "warranty_duration_months": 48,
    "warranty_end_date": "2029-01-15",
    "coverage_type": "full",
    "warranty_status": "active",
    "warranty_notes": "Extended warranty applied",
    "order_number": "ORD-2025-001",
    "external_order_number": "EXT-5678",
    "warranty_external_id": "W-99001",
    "contact": {
      "contact_id": 42,
      "first_name": "John",
      "last_name": "Doe",
      "email": "john@example.com",
      "phone": "555-999-8888",
      "address": "123 Marina Blvd",
      "zipcode": "33101",
      "city": "Miami",
      "state": "FL",
      "country_code": "US"
    }
  },
  "meta": {
    "timestamp": "2025-01-15T14:30:00.000000Z",
    "version": "0.1.2"
  }
}
Try It Out
cURL Preview
PATCH https://api.marquatica.com/api/v1/warranty/{hin}
Base URL
Authorization
Bearer Token
Path Parameters
* hin required
Body Parameters
warranty_duration_months optional
coverage_type optional
warranty_status optional
warranty_notes optional
Contact (partial update)
contact.first_name optional
contact.last_name optional
contact.email optional
contact.phone optional
contact.zipcode 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