Get Incentives for a VIN or Make

Current manufacturer incentives on new vehicles in a ZIP code: cash rebates, dealer cash, special APR financing and other offers. For a VIN, the offers on its vehicle; for a make, the offers on every model of the make on sale, each offer labelled with its year, make and model.

Authorization

AuthorizationBearer <token>

Use your API key in the Authorization header: Authorization: Bearer YOUR_API_KEY

In: header

Path Parameters

vinOrMakestring

A 17-character VIN, or a make, e.g. toyota

Query Parameters

zip?string

US ZIP code the offers apply in; zipcode is also accepted. Defaults to the ZIP code of the location the request comes from.

year?integer

Model year, for a make or a make and model. Without it, offers cover last year, this year and next year.

Response Body

curl -X GET "https://api.auto.dev/incentives/string?zip=string&year=0"

curl -X GET "https://api.auto.dev/incentives/string?zip=string&year=0"

{
  "vehicle": {
    "vin": "3C4NJDCN8RT152187",
    "year": 2024,
    "make": "Jeep",
    "model": "Compass",
    "manufacturer": "FCA Mexico S.A. de C.V."
  },
  "zip": "90210",
  "data": [
    {
      "title": "Other Offers - Employee Pricing",
      "type": "MISCELLANEOUS",
      "category": "OTHER",
      "subcategory": "OTHER",
      "financing": false,
      "leasing": false,
      "condition": "new",
      "disclaimer": "Friends of Stellantis employees may be eligible for special pricing.",
      "startDate": "2024-01-03T08:00:00.000Z",
      "endDate": "2027-01-01T07:59:59.999Z"
    },
    {
      "title": "Customer Cash - Adaptive Equipment Allowance",
      "type": "CASH_REBATE",
      "category": "REBATES",
      "subcategory": "CUSTOMERCASH",
      "totalCash": 1000,
      "financing": false,
      "leasing": false,
      "condition": "new",
      "disclaimer": "The FCA US Driveability / Automobility Program offers eligible physically challenged (physically disabled) U.S. retail consumers a cash allowance applied to the retail purchase (Type 1 sale), Lease (Type Sale L), or business (Type B or Type E) or 2nd Stage Manufacturer (Type Sale 8) of adaptive driving or passenger equipment installed on a new eligible vehicle. Authorized FCA US LLC dealerships are eligible to apply the cash reimbursement on lowered floor conversions only (a maximum of up to $1,000) to the complete purchase or lease of an eligible adapted vehicle transaction; qualifying the dealer for direct cash allowance reimbursement under this program. Refer to the Authorized Dealer Section of the rules for further definitions, eligibilities and details. Restrictions apply.",
      "startDate": "2024-01-03T08:00:00.000Z",
      "endDate": "2027-01-01T07:59:59.999Z"
    }
  ]
}

{
  "error": {
    "status": 404,
    "error": "No current incentives found in ZIP 90210",
    "code": "RESOURCE_NOT_FOUND",
    "path": "/incentives/1FMCU0G60LUA05025",
    "requestId": "a59869698b0b1d5f"
  }
}

{
  "error": {
    "status": 0,
    "error": "string",
    "code": "string",
    "path": "string",
    "requestId": "string",
    "reason": "not_yet_available",
    "retryable": true,
    "detectedMarket": {
      "country": "string",
      "region": "string"
    },
    "detectedClass": {
      "vehicleType": "string"
    }
  },
  "vin": "string",
  "vinValid": true
}