List Warranties

GET /api/v1/warranty

Returns a paginated list of warranties you have access to. Use query parameters to filter results.

Query Parameters

Parameter	Type	Required	Description
hin	string	No	Filter by specific HIN
brand_id	integer	No	Filter by brand ID
warranty_status	string	No	Filter by status: `active`, `expired`, `voided`
page	integer	No	Page number (default: 1)
limit	integer	No	Results per page (default: 20, max: 100)

Example Request

curl -X GET "https://api.marquatica.com/api/v1/warranty?brand_id=1&warranty_status=active&page=1&limit=20" \
  -H "Authorization: Bearer <Token>"

Success Response

{
  "success": true,
  "status": 200,
  "data": [
    {
      "hin": "ABC12345DE78",
      "brand_id": 1,
      "model": "Model XYZ",
      "model_year": "2025",
      "registration_date": "2025-01-15",
      "warranty_notes": null,
      "warranty_status": "active",
      "contact": {
        "first_name": "John",
        "last_name": "Doe",
        "email": "john@example.com",
        "phone": "555-123-4567",
        "zipcode": "33101"
      }
    }
  ],
  "meta": {
    "timestamp": "2025-01-15T14:30:00.000000Z",
    "version": "0.1.2"
  }
}

Try It Out

cURL Preview

GET https://api.marquatica.com/api/v1/warranty

Base URL

Authorization

Bearer Token

Query Parameters

hin optional

brand_id optional

warranty_status optional

page optional

limit optional

Response

Send a request to see the response