Get Warranty by HIN

Returns the full warranty details for a specific HIN.

Path Parameters

Example Request

curl -X GET https://api.marquatica.com/api/v1/warranty/ABC12345DE78 \
  -H "Authorization: Bearer <Token>"

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": 36,
    "warranty_end_date": "2028-01-15",
    "coverage_type": "full",
    "warranty_status": "active",
    "warranty_notes": "New boat purchase",
    "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-123-4567",
      "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"
  }
}

Error Response

{
  "success": false,
  "status": 404,
  "error": {
    "code": "WARRANTY_NOT_FOUND",
    "message": "Warranty not found"
  },
  "meta": {
    "timestamp": "2025-01-15T14:30:00.000000Z",
    "version": "0.1.2"
  }
}