Incentives API

Current manufacturer incentives on new vehicles in a ZIP code, by VIN, make, or make and model

Try it

Get the manufacturer incentives offered on new vehicles in a ZIP code right now: cash rebates, dealer cash, special APR financing and other offers. Ask by VIN for the offers on that vehicle, by make for every model of the make on sale, or by make and model.

Endpoints

GET https://api.auto.dev/incentives/{vin}
GET https://api.auto.dev/incentives/{make}
GET https://api.auto.dev/incentives/{make}/{model}

View in Browser

https://api.auto.dev/incentives/toyota/rav4?zip=90210

Parameters

PropTypeDefault
vin?
string
-
make?
string
-
model?
string
-
zip?
string
-
year?
number
-

Example Request

curl -X GET "https://api.auto.dev/incentives/toyota/rav4?zip=90210" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response Structure

PropTypeDefault
vehicle?
object
-
zip?
string
-
data?
array
-

Offer Fields

An offer has only the fields that apply to it.

PropTypeDefault
year?
string
-
make?
string
-
model?
string
-
title?
string
-
type?
string
-
category?
string
-
subcategory?
string
-
totalCash?
number
-
cashDescription?
string
-
apr?
number
-
term?
number
-
creditTier?
string
-
creditScoreMin?
number
-
creditScoreMax?
number
-
financing?
boolean
-
leasing?
boolean
-
condition?
string
-
description?
string
-
disclaimer?
string
-
startDate?
string
-
endDate?
string
-

Example Response

A 2026 Toyota RAV4 in ZIP 90210, recorded 2026-11-12, three of its seven offers. Offers change over time.

{
  "zip": "90210",
  "data": [
    {
      "year": "2026",
      "make": "Toyota",
      "model": "RAV4",
      "title": "Customer APR - Special APR",
      "type": "LOW_APR",
      "category": "FINANCING",
      "subcategory": "ALL",
      "apr": 4.99,
      "term": 24,
      "creditTier": "Tier 1",
      "creditScoreMin": 720,
      "creditScoreMax": 899,
      "financing": true,
      "leasing": false,
      "condition": "new",
      "description": "4.99% APR financing for 24 months at $43.87 per month, per $1,000 financed. 4.99% APR financing for 36 months at $29.97 per month, per $1,000 financed. 4.99% APR financing for 48 months at $23.03 per month, per $1,000 financed. 5.99% APR financing for 60 months at $19.33 per month, per $1,000 financed. 6.99% APR financing for 72 months at $17.05 per month, per $1,000 financed.",
      "disclaimer": "Program eligibility based on credit approval. Not all customers will qualify. Offer requires financing with TFS.",
      "startDate": "2026-11-03T08:00:00.000Z",
      "endDate": "2026-12-01T07:59:59.999Z"
    },
    {
      "year": "2026",
      "make": "Toyota",
      "model": "RAV4",
      "title": "Dealer Cash - Affiliations, Clubs or Groups Offer",
      "type": "DEALER_CASH",
      "category": "DEALER",
      "subcategory": "DEALER",
      "totalCash": 500,
      "cashDescription": "Dealer cash, paid to the dealer",
      "financing": false,
      "leasing": false,
      "condition": "new",
      "disclaimer": "Customer must be associated with USA Swimming, USA Track & Field, US Ski & Snowboard or must be an approved Toyota sponsored* Athlete. Customer must be issued a TMNA authorized NGB & Toyota Sponsored Athlete* Incentive Offer Consumer Cash Form Please note that dealer cash is payable to the dealer and not the consumer. These incentives for the dealer are applied independently of any customer incentives the manufacturer may be offering directly to the consumer.",
      "startDate": "2026-04-01T07:00:00.000Z",
      "endDate": "2027-04-01T06:59:59.999Z"
    },
    {
      "year": "2026",
      "make": "Toyota",
      "model": "RAV4",
      "title": "Customer Cash - Student or College Grad Offer",
      "type": "CASH_REBATE",
      "category": "REBATES",
      "subcategory": "CUSTOMERCASH",
      "totalCash": 500,
      "financing": false,
      "leasing": false,
      "condition": "new",
      "disclaimer": "Current students/recent graduates of accredited colleges, universities, and vocational/technical schools may receive special incentives on select vehicles. Proof of enrollment/graduation required. See retailer for complete eligibility requirements and acceptable documentation.",
      "startDate": "2026-11-03T08:00:00.000Z",
      "endDate": "2026-12-01T07:59:59.999Z"
    }
  ]
}

A VIN request also carries vehicle, the vehicle the offers are for:

{
  "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"
    }
  ]
}

Error Responses

Errors come wrapped in an error object. Every response also carries the api and user blocks, omitted from the examples below.

No Current Offers

No current offers in the ZIP code answers 404 with code RESOURCE_NOT_FOUND:

{
  "error": {
    "status": 404,
    "error": "No current incentives found for toyota notamodel in ZIP 90210",
    "code": "RESOURCE_NOT_FOUND",
    "path": "/incentives/toyota/notamodel",
    "requestId": "a5987798988e7a92"
  }
}

Incentives Unavailable

When the offers cannot be read right now, the answer is 503 with code SOURCE_ERROR. Retry later.

Interactive API Reference

Plan Availability

  • Free: ❌ Not available
  • Growth: ✅ Available
  • Scale: ✅ Available

See pricing for plan details and signup.

Was this API reference helpful?