# Data Definitions

> Detailed definitions of all fields in the MarketCheck Incentives dataset

This guide provides detailed definitions of all fields in the MarketCheck Incentives dataset. Understanding these fields is essential for developers and analysts to effectively use our incentive data feeds and APIs.



## Field Definitions



### id

Unique identifier for each incentive offer document generated as a SHA-256 hash of the complete offer content. This field ensures document uniqueness across the entire dataset and serves as the primary key for database operations and data synchronization.

**Source**: Generated - SHA-256 hash of entire offer document content

| **Attribute** | **Data Feed** | **API**       |
|---------------|---------------|---------------|
| **Name** | `id` | `id` |
| **Type** | `string` | `string` |
| **Format** | 64 characters (SHA-256 hash) | 64 characters (SHA-256 hash) |
| **Sample** | `6e0fb5c9d6c174b0e44338071fe703d942d9ef968a154417dc43c3dbfe4f369f` | `d6e31c4ee7775aaf803e305cf799815a297ec97c08c41912a40bf6ff1bc78a44` |


**API Parameters**

Not available as a search parameter

**See Also**

- [base_sha](#base_sha) - For deduplicating offers across locations
- [Key Concepts](/docs/guides/data/cars/incentives/key-concepts)



### base_sha

Unique identifier for incentive offers that groups identical programs across different geographic locations. Generated by hashing the offer content excluding location-specific fields like zipcode. Essential for deduplicating offers that appear in multiple MSAs or ZIP codes.

**Source**: Generated - SHA-256 hash excluding `zipcode`, `city`, `state` fields

| **Attribute** | **Data Feed** | **API**       |
|---------------|---------------|---------------|
| **Name** | `base_sha` | `base_sha` |
| **Type** | `string` | `string` |
| **Format** | 64 characters (SHA-256 hash) | 64 characters (SHA-256 hash) |
| **Sample** | `8cce57930c2b0c5130de2b05542317698a1ca715ba25df028bd7c267e7409361` | `4559667aedb494d2b0c47e5cb2325f59ccad8925d4cdce73aee6bbe8d2aff1ff` |


**API Parameters**

- `base_sha` - Filter by specific base SHA value

**See Also**

- [id](#id) - Complete document identifier
- [Key Concepts](/docs/guides/data/cars/incentives/key-concepts)



### nlp_sha

Unique identifier generated from the textual content fields (titles, offers, disclaimers) of an incentive offer. Used for natural language processing and text-based analysis to identify offers with identical promotional content regardless of other attributes.

This field is only available in the data feed.

**Source**: Generated - SHA-256 hash of concatenated `titles`, `offers`, and `disclaimers` fields

| **Attribute** | **Data Feed** |
|---------------|---------------|
| **Name** | `nlp_sha` |
| **Type** | `string` |
| **Format** | 64 characters (SHA-256 hash) |
| **Sample** | `8cce57930c2b0c5130de2b05542317698a1ca715ba25df028bd7c267e7409361` |


**API Parameters**

Not available in API

**See Also**

- [titles](#titles) - Offer headline text
- [offers](#offers) - Primary offer text
- [disclaimers](#disclaimers) - Fine print content



### make

Automotive manufacturer brand name for vehicles eligible for the incentive program. Standardized across all MarketCheck datasets using consistent naming conventions. Critical for filtering offers by specific OEM manufacturers.

**Source**: Enriched - Vehicle decoder using VIN and model information from MarketCheck vehicle database and OEM specifications

| **Attribute** | **Data Feed** | **API**       |
|---------------|---------------|---------------|
| **Name** | `make` | `vehicles[].make` |
| **Type** | `string` | `string` |
| **Format** | Variable, typically 3-15 characters | Variable, typically 3-15 characters |
| **Sample** | `Toyota` | `Ford` |


**API Parameters**

- `make` - Filter by manufacturer name

**See Also**

- [model](#model) - Vehicle model information
- [vehicles](#vehicles) - Complete vehicle array structure



### model

Specific vehicle model name within a manufacturer's lineup that is eligible for the incentive program. Standardized naming ensures consistency across all MarketCheck products and enables precise filtering of incentive offers by vehicle type.

**Source**: Enriched - Vehicle decoder and OEM model specifications from MarketCheck vehicle database and manufacturer catalogs

| **Attribute** | **Data Feed** | **API**       |
|---------------|---------------|---------------|
| **Name** | `model` | `vehicles[].model` |
| **Type** | `string` | `string` |
| **Format** | Variable, typically 3-25 characters | Variable, typically 3-25 characters |
| **Sample** | `Camry` | `F-150` |


**API Parameters**

- `model` - Filter by vehicle model name

**See Also**

- [make](#make) - Manufacturer information
- [trim](#trim) - Vehicle trim level details



### year

Model year of vehicles eligible for the incentive program. Represents the manufacturer's designated model year, which may differ from production year. Essential for targeting specific vehicle vintages and understanding program scope across model years.

**Source**: Enriched - Vehicle decoder and OEM model specifications from MarketCheck vehicle database

| **Attribute** | **Data Feed** | **API**       |
|---------------|---------------|---------------|
| **Name** | `year` | `vehicles[].year` |
| **Type** | `integer` | `integer` |
| **Format** | Typically 2024-2026 for current programs | Typically 2024-2026 for current programs |
| **Sample** | `2024` | `2025` |


**API Parameters**

- `year` - Filter by specific model year
- `year_range` - Filter by year range (e.g., "2023-2025")

**See Also**

- [make](#make) - Manufacturer information
- [model](#model) - Vehicle model details



### trim

Specific trim level or configuration variant of a vehicle model eligible for the incentive program. Trim levels indicate equipment packages, feature sets, and pricing tiers within a model lineup.

**Source**: Enriched - Vehicle decoder and OEM trim specifications from MarketCheck vehicle database and manufacturer specifications

| **Attribute** | **Data Feed** | **API**       |
|---------------|---------------|---------------|
| **Name** | `trim` | `vehicles[].trim` |
| **Type** | `string` | `string` |
| **Format** | Variable, typically 2-20 characters | Variable, typically 2-20 characters |
| **Sample** | `LE` | `XLE` |


**API Parameters**

- `trim` - Filter by specific trim level

**See Also**

- [make](#make) - Manufacturer information
- [model](#model) - Vehicle model details



### drivetrain

Drive system configuration of vehicles eligible for the incentive program. Indicates how power is transmitted from the engine to the wheels, affecting vehicle performance, fuel efficiency, and pricing. Important for matching incentives to specific vehicle configurations.

**Source**: Enriched - Vehicle decoder and technical specifications from MarketCheck vehicle database and OEM technical data

| **Attribute** | **Data Feed** | **API**       |
|---------------|---------------|---------------|
| **Name** | `drivetrain` | `vehicles[].drivetrain` |
| **Type** | `string` | `string` |
| **Format** | Variable, typically 3-10 characters | Variable, typically 3-10 characters |
| **Sample** | `FWD` | `AWD` |


**API Parameters**

- `drivetrain` - Filter by drivetrain type

**See Also**

- [transmission](#transmission) - Transmission type
- [engine](#engine) - Engine specifications



### transmission

Transmission type for vehicles eligible for the incentive program. Indicates the gear-changing mechanism (automatic, manual, or continuously variable) which affects vehicle performance, fuel economy, and consumer preferences in incentive targeting.

**Source**: Enriched - Vehicle decoder and technical specifications from MarketCheck vehicle database and OEM technical data

| **Attribute** | **Data Feed** | **API**       |
|---------------|---------------|---------------|
| **Name** | `transmission` | `vehicles[].transmission` |
| **Type** | `string` | `string` |
| **Format** | Variable, typically 6-15 characters | Variable, typically 6-15 characters |
| **Sample** | `Automatic` | `Manual` |


**API Parameters**

- `transmission` - Filter by transmission type

**See Also**

- [drivetrain](#drivetrain) - Drive system configuration
- [engine](#engine) - Engine specifications



### engine

Engine specifications for vehicles eligible for the incentive program. Provides detailed engine information including displacement, configuration, and technology features. Critical for matching incentives to specific powertrain options within a model lineup.

**Source**: Enriched - Vehicle decoder and technical specifications from MarketCheck vehicle database and OEM technical data

| **Attribute** | **Data Feed** | **API**       |
|---------------|---------------|---------------|
| **Name** | `engine` | `vehicles[].engine` |
| **Type** | `string` | `string` |
| **Format** | Variable, typically 10-40 characters | Variable, typically 10-40 characters |
| **Sample** | `2.5L 4-Cylinder` | `3.5L V6 Turbo` |


**API Parameters**

- `engine` - Filter by engine specifications

**See Also**

- [drivetrain](#drivetrain) - Drive system configuration
- [transmission](#transmission) - Transmission type
- [fuel_type](#fuel_type) - Fuel type information



### fuel_type

Primary fuel type for vehicles eligible for the incentive program. Indicates the energy source (gasoline, hybrid, electric, diesel) used by the vehicle, which is increasingly important for targeting environmental and efficiency-focused incentive programs.

**Source**: Enriched - Vehicle decoder and technical specifications from MarketCheck vehicle database and OEM technical data

| **Attribute** | **Data Feed** | **API**       |
|---------------|---------------|---------------|
| **Name** | `fuel_type` | `vehicles[].fuel_type` |
| **Type** | `string` | `string` |
| **Format** | Variable, typically 3-15 characters | Variable, typically 3-15 characters |
| **Sample** | `Gasoline` | `Hybrid` |


**API Parameters**

- `fuel_type` - Filter by fuel type

**See Also**

- [engine](#engine) - Engine specifications
- [powertrain_type](#powertrain_type) - Powertrain classification



### body_type

Body style classification of vehicles eligible for the incentive program (e.g. SUV, Truck, Sedan). Used to match incentives to specific vehicle segments. Only present where the OEM explicitly mentions body type in the offer.

**Source**: Enriched - Vehicle decoder and technical specifications from MarketCheck vehicle database and OEM technical data

| **Attribute** | **Data Feed** | **API**       |
|---------------|---------------|---------------|
| **Name** | `body_type` | `vehicles[].body_type` |
| **Type** | `string` | `string` |
| **Format** | Variable, typically 3-15 characters | Variable, typically 3-15 characters |
| **Sample** | `SUV` | `Truck` |


**API Parameters**

- `body_type` - Filter by body type. Supports comma-separated multi-value (e.g. `body_type=SUV,Truck`)

**See Also**

- [drivetrain](#drivetrain) - Drive system configuration
- [fuel_type](#fuel_type) - Fuel type information



### offer_type

Primary category of the incentive program indicating the fundamental structure of the offer. Distinguishes between cash rebates, financing promotions, and lease deals to help consumers and dealers quickly identify relevant programs for their needs.

**Source**: Scraped - Extracted from OEM website offer content and structure, classified based on offer terms and payment structures

| **Attribute** | **Data Feed** | **API**       |
|---------------|---------------|---------------|
| **Name** | `offer_type` | `offer_type` |
| **Type** | `string` | `string` |
| **Format** | Variable, typically 4-10 characters | Variable, typically 4-10 characters |
| **Sample** | `cash` | `finance` |


**API Parameters**

- `offer_type` - Filter by incentive type

**See Also**

- [cashback_amount](#cashback_amount) - Cash rebate details
- [apr](#apr) - Financing rate information
- [monthly_payment](#monthly_payment) - Lease payment details



### monthly

Monthly payment amount for lease incentive programs. Represents the advertised monthly cost to lease the vehicle under the promotional terms. Critical metric for consumers comparing lease offers and understanding total cost of vehicle access.

**Source**: Scraped - Extracted from OEM lease offer terms and promotional content

| **Attribute** | **Data Feed** | **API**       |
|---------------|---------------|---------------|
| **Name** | `monthly` | `amounts[].monthly` |
| **Type** | `float` | `float` |
| **Format** | 2 decimal places, USD currency | 2 decimal places, USD currency |
| **Sample** | `299.00` | `399.99` |


**API Parameters**

- `monthly_range` - Filter by monthly payment range

**See Also**

- [lease_term](#lease_term) - Lease duration
- [due_at_signing](#due_at_signing) - Initial payment requirements



### apr

Annual Percentage Rate for financing incentive programs. Represents the yearly cost of borrowing money to purchase the vehicle, including interest and fees. Lower APR rates indicate more attractive financing terms and reduced total cost of ownership.

**Source**: Scraped - Extracted from OEM financing offer terms and promotional content

| **Attribute** | **Data Feed** | **API**       |
|---------------|---------------|---------------|
| **Name** | `apr` | `amounts[].apr` |
| **Type** | `float` | `float` |
| **Format** | 2 decimal places, percentage | 2 decimal places, percentage |
| **Sample** | `2.9` | `3.9` |


**API Parameters**

- `apr_range` - Filter by APR range

**See Also**

- [finance_term](#finance_term) - Loan duration
- [offer_type](#offer_type) - Incentive type classification



### term

Duration of the agreement in months for both lease and finance incentive programs. Indicates the commitment period for the promotional terms, whether for a lease or a loan. Longer terms typically result in lower monthly payments for leases and lower monthly installments for financing, but may increase total cost over the agreement period.

**Source**: Scraped - Extracted from OEM offer terms and agreement details

| **Attribute** | **Data Feed** | **API**       |
|---------------|---------------|---------------|
| **Name** | `term` | `amounts[].term` |
| **Type** | `integer` | `integer` |
| **Format** | Months, typically 24-84 months | Months, typically 24-84 months |
| **Sample** | `36` (lease) | `60` (finance) |


**API Parameters**

- `term_range` - Filter by term range
- `term_unit` - Specify term unit (months)

**See Also**

- [monthly_payment](#monthly_payment) - Monthly payment amount for leases
- [apr](#apr) - Financing rate for loans
- [mileage_allowance](#mileage_allowance) - Annual mileage limits for leases
- [down_payment](#down_payment) - Initial payment requirements



### cashback_amount

Dollar amount of cash rebate offered directly to customers for cash incentive programs. Represents immediate price reduction or rebate check provided by the manufacturer to reduce the effective purchase price of the vehicle.

**Source**: Scraped - Extracted from OEM cash rebate offers and promotional content

| **Attribute** | **Data Feed** | **API**       |
|---------------|---------------|---------------|
| **Name** | `cashback_amount` | `cashback_amount` |
| **Type** | `float` | `float` |
| **Format** | 2 decimal places, USD currency | 2 decimal places, USD currency |
| **Sample** | `2500.00` | `1000.00` |


**API Parameters**

- `cashback_amount_range` - Filter by cashback amount range

**See Also**

- [offer_type](#offer_type) - Incentive type classification
- [cashback_target_group](#cashback_target_group) - Eligibility requirements



### cashback_target_group

Specific customer segment or eligibility criteria for cash rebate programs. Identifies target demographics, professions, or customer types eligible for special rebate amounts. Common targeting includes military personnel, recent graduates, or loyalty program members.

**Source**: Scraped - Extracted from OEM rebate eligibility requirements and program terms

| **Attribute** | **Data Feed** | **API**       |
|---------------|---------------|---------------|
| **Name** | `cashback_target_group` | `cashback_target_group` |
| **Type** | `string` | `string` |
| **Format** | Variable, typically 10-30 characters | Variable, typically 10-30 characters |
| **Sample** | `Military` | `Recent Graduate` |


**API Parameters**

- `cashback_target_group` - Filter by target group

**See Also**

- [cashback_amount](#cashback_amount) - Rebate amount details
- [disclaimers](#disclaimers) - Detailed eligibility terms



### down_payment

Initial payment required at lease or purchase signing for incentive programs. Represents the upfront cash requirement to secure the promotional terms. Lower down payments make offers more accessible but may result in higher monthly payments.

**Source**: Scraped - Extracted from OEM offer terms and payment requirements

| **Attribute** | **Data Feed** | **API**       |
|---------------|---------------|---------------|
| **Name** | `down_payment` | `down_payment` |
| **Type** | `float` | `float` |
| **Format** | 2 decimal places, USD currency | 2 decimal places, USD currency |
| **Sample** | `2999.00` | `0.00` |


**API Parameters**

- `down_payment_range` - Filter by down payment range

**See Also**

- [due_at_signing](#due_at_signing) - Total initial payment
- [monthly_payment](#monthly_payment) - Ongoing payment amount



### due_at_signing

Total amount due at lease signing including down payment, first month payment, fees, and taxes. Represents the complete upfront cost to secure the lease agreement. Critical for understanding true initial financial commitment beyond advertised down payment.

**Source**: Scraped - Extracted from OEM lease terms and signing requirements

| **Attribute** | **Data Feed** | **API**       |
|---------------|---------------|---------------|
| **Name** | `due_at_signing` | `due_at_signing` |
| **Type** | `float` | `float` |
| **Format** | 2 decimal places, USD currency | 2 decimal places, USD currency |
| **Sample** | `3499.00` | `299.00` |


**API Parameters**

- `due_at_signing_range` - Filter by signing amount range

**See Also**

- [down_payment](#down_payment) - Down payment component
- [monthly_payment](#monthly_payment) - Monthly payment amount



### msrp

Manufacturer's Suggested Retail Price for the vehicle featured in the incentive program. Provides baseline pricing reference to understand the value of promotional offers and calculate effective discount percentages from standard pricing.

**Source**: Scraped - Extracted from OEM pricing information and offer disclaimers

| **Attribute** | **Data Feed** | **API**       |
|---------------|---------------|---------------|
| **Name** | `msrp` | `msrp` |
| **Type** | `float` | `float` |
| **Format** | 2 decimal places, USD currency | 2 decimal places, USD currency |
| **Sample** | `32995.00` | `28450.00` |


**API Parameters**

- `msrp_range` - Filter by MSRP range

**See Also**

- [net_cap_cost](#net_cap_cost) - Lease capitalized cost
- [cashback_amount](#cashback_amount) - Direct rebate amount



### security_deposit

Refundable deposit required for lease agreements to secure the vehicle and cover potential excess wear or damage. Amount is typically equivalent to one monthly payment and is returned at lease end if vehicle condition meets standards.

**Source**: Scraped - Extracted from OEM lease terms and deposit requirements

| **Attribute** | **Data Feed** | **API**       |
|---------------|---------------|---------------|
| **Name** | `security_deposit` | `security_deposit` |
| **Type** | `float` | `float` |
| **Format** | 2 decimal places, USD currency | 2 decimal places, USD currency |
| **Sample** | `0.00` | `299.00` |


**API Parameters**

- `security_deposit_range` - Filter by security deposit range

**See Also**

- [due_at_signing](#due_at_signing) - Total signing amount
- [monthly_payment](#monthly_payment) - Monthly payment amount



### acquisition_fee

Administrative fee charged by leasing companies to initiate the lease agreement. Covers processing, documentation, and setup costs for the lease contract. This fee is typically built into the lease terms or paid upfront at signing.

**Source**: Scraped - Extracted from OEM lease terms and fee disclosures

| **Attribute** | **Data Feed** | **API**       |
|---------------|---------------|---------------|
| **Name** | `acquisition_fee` | `acquisition_fee` |
| **Type** | `float` | `float` |
| **Format** | 2 decimal places, USD currency | 2 decimal places, USD currency |
| **Sample** | `395.00` | `595.00` |


**API Parameters**

- `acquisition_fee_range` - Filter by acquisition fee range

**See Also**

- [disposition_fee](#disposition_fee) - Lease-end fee
- [due_at_signing](#due_at_signing) - Total initial payment



### disposition_fee

Fee charged at the end of a lease agreement to cover vehicle inspection, reconditioning, and remarketing costs. Paid when returning the vehicle unless purchasing or leasing another vehicle from the same manufacturer, depending on program terms.

**Source**: Scraped - Extracted from OEM lease terms and end-of-lease fee disclosures

| **Attribute** | **Data Feed** | **API**       |
|---------------|---------------|---------------|
| **Name** | `disposition_fee` | `disposition_fee` |
| **Type** | `float` | `float` |
| **Format** | 2 decimal places, USD currency | 2 decimal places, USD currency |
| **Sample** | `395.00` | `595.00` |


**API Parameters**

- `disposition_fee_range` - Filter by disposition fee range

**See Also**

- [acquisition_fee](#acquisition_fee) - Lease initiation fee
- [lease_end_purchase_price](#lease_end_purchase_price) - Purchase option price



### dealer_contribution

Additional discount or incentive provided by the dealership to supplement manufacturer incentives. Represents dealer participation in promotional programs to enhance customer value and competitive positioning beyond OEM-funded programs.

**Source**: Scraped - Extracted from OEM program details indicating dealer participation requirements

| **Attribute** | **Data Feed** | **API**       |
|---------------|---------------|---------------|
| **Name** | `dealer_contribution` | `dealer_contribution` |
| **Type** | `float` | `float` |
| **Format** | 2 decimal places, USD currency | 2 decimal places, USD currency |
| **Sample** | `500.00` | `1000.00` |


**API Parameters**

- `dealer_contribution_range` - Filter by dealer contribution range

**See Also**

- [cashback_amount](#cashback_amount) - Manufacturer rebate
- [monthly_payment](#monthly_payment) - Net payment after contributions



### total_monthly_payments

Cumulative amount of all monthly payments over the lease term. Calculated by multiplying monthly payment by lease term duration. Provides total cost perspective for lease agreements to enable comparison with purchase financing options.

**Source**: Scraped - Extracted directly from OEM offer text when total monthly payments are explicitly mentioned. This field is only populated if the OEM offer text includes the total monthly payment amount.

| **Attribute** | **Data Feed** | **API**       |
|---------------|---------------|---------------|
| **Name** | `total_monthly_payments` | `total_monthly_payments` |
| **Type** | `float` | `float` |
| **Format** | 2 decimal places, USD currency | 2 decimal places, USD currency |
| **Sample** | `10764.00` | `14399.64` |


**API Parameters**

- `total_monthly_payments_range` - Filter by total payment range

**See Also**

- [monthly_payment](#monthly_payment) - Individual payment amount
- [lease_term](#lease_term) - Lease duration



### mileage_limit

Annual mileage limit included in lease agreements without additional charges. Exceeding this limit results in excess mileage fees at lease end. Higher limits provide more driving flexibility but may increase monthly payments or lease costs.

**Source**: Scraped - Extracted from OEM lease terms and mileage provisions

| **Attribute** | **Data Feed** | **API**       |
|---------------|---------------|---------------|
| **Name** | `mileage_limit` | `mileage_limit` |
| **Type** | `integer` | `integer` |
| **Format** | Miles per year, typically 10,000-15,000 annually | Miles per year, typically 10,000-15,000 annually |
| **Sample** | `12000` | `10000` |


**API Parameters**

- `mileage_limit_range` - Filter by mileage limit range

**See Also**

- [over_mileage_fee](#over_mileage_fee) - Excess mileage charges
- [lease_term](#lease_term) - Lease duration



### over_mileage_fee

Cost per mile charged for exceeding the lease mileage limit. Applied to total excess miles at lease end to compensate for additional vehicle wear and reduced residual value. Critical factor in lease cost calculation for high-mileage drivers.

**Source**: Scraped - Extracted from OEM lease terms and excess mileage provisions

| **Attribute** | **Data Feed** | **API**       |
|---------------|---------------|---------------|
| **Name** | `over_mileage_fee` | `over_mileage_fee` |
| **Type** | `float` | `float` |
| **Format** | 3 decimal places, USD per mile | 3 decimal places, USD per mile |
| **Sample** | `0.250` | `0.200` |


**API Parameters**

- `over_mileage_fee_range` - Filter by excess mileage fee range

**See Also**

- [mileage_allowance](#mileage_allowance) - Annual mileage limit
- [lease_term](#lease_term) - Lease duration



### lease_end_purchase_price

Predetermined price to purchase the leased vehicle at lease expiration. Also known as residual value, this amount is established at lease inception based on projected vehicle depreciation and enables lessees to buy their vehicle.

**Source**: Scraped - Extracted from OEM lease terms and purchase option details

| **Attribute** | **Data Feed** | **API**       |
|---------------|---------------|---------------|
| **Name** | `lease_end_purchase_price` | `amounts[].lease_end_purchase_price` |
| **Type** | `float` | `float` |
| **Format** | 2 decimal places, USD currency | 2 decimal places, USD currency |
| **Sample** | `18650.00` | `22995.00` |


**API Parameters**

- `lease_end_purchase_price_range` - Filter by purchase price range

**See Also**

- [msrp](#msrp) - Original vehicle price
- [net_cap_cost](#net_cap_cost) - Lease capitalization cost



### net_cap_cost

Adjusted capitalized cost used to calculate lease payments after applying all rebates, trade-in credits, and down payments. Represents the financed amount that determines monthly payment calculations and total lease cost structure.

**Source**: Scraped - Extracted from OEM lease calculation details and cost breakdowns

| **Attribute** | **Data Feed** | **API**       |
|---------------|---------------|---------------|
| **Name** | `net_cap_cost` | `net_cap_cost` |
| **Type** | `float` | `float` |
| **Format** | 2 decimal places, USD currency | 2 decimal places, USD currency |
| **Sample** | `25995.00` | `31450.00` |


**API Parameters**

- `net_cap_cost_range` - Filter by net capitalized cost range

**See Also**

- [gross_cap_cost](#gross_cap_cost) - Initial capitalized cost
- [monthly_payment](#monthly_payment) - Resulting payment amount



### gross_cap_cost

Initial capitalized cost before applying rebates, trade-ins, or down payments in lease calculations. Represents the starting value used for lease structuring before incentives reduce the financed amount to determine final lease terms.

**Source**: Scraped - Extracted from OEM lease calculation details and cost breakdowns

| **Attribute** | **Data Feed** | **API**       |
|---------------|---------------|---------------|
| **Name** | `gross_cap_cost` | `gross_cap_cost` |
| **Type** | `float` | `float` |
| **Format** | 2 decimal places, USD currency | 2 decimal places, USD currency |
| **Sample** | `28995.00` | `34450.00` |


**API Parameters**

- `gross_cap_cost_range` - Filter by gross capitalized cost range

**See Also**

- [net_cap_cost](#net_cap_cost) - Adjusted capitalized cost
- [msrp](#msrp) - Manufacturer suggested price



### valid_from

Start date of the incentive program as specified by the manufacturer. Indicates when customers can begin utilizing the promotional terms. Programs may have future effective dates to coordinate with model year launches or seasonal campaigns.

**Source**: Scraped - Extracted from OEM offer validity periods and program terms

| **Attribute** | **Data Feed** | **API**       |
|---------------|---------------|---------------|
| **Name** | `valid_from` | `valid_from` |
| **Type** | `string` | `string` |
| **Format** | US MDY format (MM/DD/YYYY) | US MDY format (MM/DD/YYYY) |
| **Sample** | `01/01/2024` | `03/15/2024` |


**API Parameters**

- `valid_from_range` - Filter by program start date range

**See Also**

- [valid_through](#valid_through) - Program end date
- [scraped_at_date](#scraped_at_date) - Initial discovery date
- [status_date](#status_date) - Last verified date



### valid_through

End date of the incentive program as specified by the manufacturer. Indicates the final date customers can secure the promotional terms. Programs typically align with monthly or quarterly sales cycles and model year transitions.

**Source**: Scraped - Extracted from OEM offer validity periods and program expiration terms

| **Attribute** | **Data Feed** | **API**       |
|---------------|---------------|---------------|
| **Name** | `valid_through` | `valid_through` |
| **Type** | `string` | `string` |
| **Format** | US MDY format (MM/DD/YYYY) | US MDY format (MM/DD/YYYY) |
| **Sample** | `03/31/2024` | `06/30/2024` |


**API Parameters**

- `valid_through_range` - Filter by program end date range

**See Also**

- [valid_from](#valid_from) - Program start date
- [scraped_at_date](#scraped_at_date) - Initial discovery date
- [status_date](#status_date) - Last verified date



### status_date

Timestamp when MarketCheck last verified the incentive offer on the OEM website. Updated daily during crawling operations to confirm program availability. Offers not updated within 24 hours are automatically removed from active datasets.

**Source**: Generated - Updated automatically during daily crawling operations (set to current timestamp when offer is found during crawl)

| **Attribute** | **Data Feed** | **API**       |
|---------------|---------------|---------------|
| **Name** | `status_date` | `status_date` |
| **Type** | `integer` (Unix timestamp) | `string` (ISO 8601 format) |
| **Format** | Unix seconds timestamp | ISO-8601 datetime string (YYYY-MM-DDThh:mm:ssZ) |
| **Sample** | `1705328600` | `2024-01-15T14:30:00Z` |


**API Parameters**

- `status_date_range` - Filter by last verification date range

**See Also**

- [scraped_at_date](#scraped_at_date) - Initial discovery date
- [Listing Lifecycle](/docs/guides/data/cars/incentives/listing-lifecycle)



### scraped_at_date

Timestamp when MarketCheck first discovered the incentive offer on the OEM website. Remains constant throughout the offer's lifecycle to track program introduction timing. Essential for understanding offer longevity and historical program analysis.

**Source**: Generated - Set during initial offer discovery (timestamp of first successful crawl capturing the offer)

| **Attribute** | **Data Feed** | **API**       |
|---------------|---------------|---------------|
| **Name** | `scraped_at_date` | `scraped_at_date` |
| **Type** | `integer` (Unix timestamp) | `string` (ISO 8601 format) |
| **Format** | Unix seconds timestamp | ISO-8601 datetime string (YYYY-MM-DDThh:mm:ssZ) |
| **Sample** | `1704099300` | `2024-01-01T09:15:00Z` |


**API Parameters**

- `scraped_at_date_range` - Filter by initial discovery date range

**See Also**

- [status_date](#status_date) - Last verification date
- [Listing Lifecycle](/docs/guides/data/cars/incentives/listing-lifecycle)



### zipcode

ZIP code used to crawl the incentive offer from the OEM website. Represents the specific geographic location where the offer was discovered, typically one representative ZIP code per MSA for comprehensive national coverage.

**Source**: Generated - Selected using MSA sampling strategy (one ZIP code per MSA based on dealer presence and population density)

| **Attribute** | **Data Feed** | **API**       |
|---------------|---------------|---------------|
| **Name** | `zipcode` | `zipcode` |
| **Type** | `string` | `string` |
| **Format** | 5 digits, US ZIP code format | 5 digits, US ZIP code format |
| **Sample** | `90210` | `10001` |


**API Parameters**

- `zip` - Filter by specific ZIP code

**See Also**

- [msa_code](#msa_code) - Metropolitan Statistical Area
- [state](#state) - State location
- [Overview](/docs/guides/data/cars/incentives/overview)



### msa_code

Metropolitan Statistical Area code where the incentive offer is valid. Represents the broader geographic region served by the offer, as incentives available in one ZIP code within an MSA typically apply to all ZIP codes in that MSA.

**Source**: Enriched - Derived from ZIP code geographic mapping using US Census Bureau MSA definitions

| **Attribute** | **Data Feed** | **API**       |
|---------------|---------------|---------------|
| **Name** | `msa_code` | `msa_code` |
| **Type** | `string` | `string` |
| **Format** | 5 digits, US Census MSA code format | 5 digits, US Census MSA code format |
| **Sample** | `31080` | `35620` |


**API Parameters**

- `msa_code` - Filter by MSA code

**See Also**

- [zipcode](#zipcode) - Specific crawl location
- [state](#state) - State location
- [city](#city) - City location



### state

US state abbreviation where the incentive offer is valid. Provides state-level geographic filtering for regional program analysis and compliance with state-specific automotive regulations and incentive programs.

**Source**: Enriched - Derived from ZIP code geographic mapping using US Postal Service state codes

| **Attribute** | **Data Feed** | **API**       |
|---------------|---------------|---------------|
| **Name** | `state` | `state` |
| **Type** | `string` | `string` |
| **Format** | 2 characters, US state abbreviation (uppercase) | 2 characters, US state abbreviation (uppercase) |
| **Sample** | `CA` | `NY` |


**API Parameters**

- `state` - Filter by state abbreviation

**See Also**

- [zipcode](#zipcode) - ZIP code location
- [msa_code](#msa_code) - MSA region
- [city](#city) - City location



### city

City name where the incentive offer is valid, derived from ZIP code geographic data. Provides local market context for incentive programs and enables city-level analysis of manufacturer promotional strategies.

**Source**: Enriched - Derived from ZIP code geographic mapping

| **Attribute** | **Data Feed** | **API**       |
|---------------|---------------|---------------|
| **Name** | `city` | `city` |
| **Type** | `string` | `string` |
| **Format** | Variable, typically 3-30 characters | Variable, typically 3-30 characters |
| **Sample** | `Beverly Hills` | `New York` |


**API Parameters**

- `city` - Filter by city name

**See Also**

- [state](#state) - State location
- [zipcode](#zipcode) - ZIP code location
- [msa_code](#msa_code) - MSA region



### country

Country where the incentive offer is valid. Currently limited to United States market coverage. Provides standardized country identification for international data consistency and future market expansion capabilities.

**Source**: Generated - Set to "US" for all current incentive offers (fixed value based on market coverage scope)

| **Attribute** | **Data Feed** | **API**       |
|---------------|---------------|---------------|
| **Name** | `country` | `country` |
| **Type** | `string` | `string` |
| **Format** | 2 characters, ISO 3166-1 alpha-2 country code | 2 characters, ISO 3166-1 alpha-2 country code |
| **Sample** | `US` | `US` |


**API Parameters**

- `country` - Filter by country code

**See Also**

- [state](#state) - State location
- [Overview](/docs/guides/data/cars/incentives/overview)



### dealer_id

MarketCheck identifier for the OEM.

**Source**: Enriched - Matched using dealership location and franchise data from MarketCheck dealer database

| **Attribute** | **Data Feed** | **API**       |
|---------------|---------------|---------------|
| **Name** | `dealer_id` | `dealer_id` |
| **Type** | `integer` | `integer` |
| **Format** | Positive integer values | Positive integer values |
| **Sample** | `12345` | `67890` |


**API Parameters**

- `dealer_id` - Filter by specific dealer ID

**See Also**

- [zipcode](#zipcode) - Dealer location ZIP
- [msa_code](#msa_code) - Dealer market area



### source

Data source identifier indicating the OEM website from which the incentive offer was collected. Provides transparency about data origin and enables source-specific quality analysis and troubleshooting.

**Source**: Enriched - Derived from the OEM website URL used during scraping operations

| **Attribute** | **Data Feed** | **API**       |
|---------------|---------------|---------------|
| **Name** | `source` | `source` |
| **Type** | `string` | `string` |
| **Format** | Variable, typically 10-30 characters | Variable, typically 10-30 characters |
| **Sample** | `toyota_com` | `ford_com` |


**API Parameters**

- `source` - Filter by data source

**See Also**

- [make](#make) - Vehicle manufacturer
- [Overview](/docs/guides/data/cars/incentives/overview)



### titles

Headline text or promotional titles from the OEM incentive offer as displayed on manufacturer websites. Contains the primary marketing message and key offer highlights. Multiple titles are pipe-separated when present.

**Source**: Scraped - Extracted directly from OEM website offer headlines and promotional titles

| **Attribute** | **Data Feed** | **API**       |
|---------------|---------------|---------------|
| **Name** | `titles` | `titles` |
| **Type** | `string` | `array<string>` |
| **Format** | Variable, multiple values separated by pipe (|) character | Array of strings, each representing a title |
| **Sample** | `$2,500 Customer Cash on Select 2024 Camry Models` | `["1.9% APR Financing Available", "Up to 60 Months"]` |


**API Parameters**

- `search_titles_text` - Full-text search within titles

**See Also**

- [offers](#offers) - Primary offer content
- [disclaimers](#disclaimers) - Terms and conditions



### offers

Primary offer text containing the main promotional terms and payment details as presented on OEM websites. Includes key financial information, payment structures, and program highlights. Multiple offers are pipe-separated when present.

**Source**: Scraped - Extracted directly from OEM website offer content and promotional text sections

| **Attribute** | **Data Feed** | **API**       |
|---------------|---------------|---------------|
| **Name** | `offers` | `offers` |
| **Type** | `string` | `array<string>` |
| **Format** | Variable, multiple values separated by pipe (|) character | Array of strings, each representing an offer |
| **Sample** | `Get $2,500 cash back when you finance or lease a new 2024 Camry` | `["Special 1.9% APR financing for qualified buyers", "Up to 60 months"]` |


**API Parameters**

- `search_offers_text` - Full-text search within offers

**See Also**

- [titles](#titles) - Offer headlines
- [disclaimers](#disclaimers) - Terms and conditions



### disclaimers

Fine print text containing detailed terms, conditions, and eligibility requirements for incentive offers. Includes legal disclaimers, qualification criteria, and program restrictions. Multiple disclaimers are pipe-separated when present.

**Source**: Scraped - Extracted directly from OEM website disclaimer text and terms sections

| **Attribute** | **Data Feed** | **API**       |
|---------------|---------------|---------------|
| **Name** | `disclaimers` | `disclaimers` |
| **Type** | `string` | `array<string>` |
| **Format** | Variable,multiple values separated by pipe (|) character | Array of strings, each representing a disclaimer |
| **Sample** | `For qualified buyers with approved credit. Offer expires 12/31/2024. See dealer for details.` | `["Closed-end lease with 10,000 miles per year.", "$0.25 per excess mile.", "Plus tax, title, license."]` |


**API Parameters**

- `search_disclaimers_text` - Full-text search within disclaimers

**See Also**

- [titles](#titles) - Offer headlines
- [offers](#offers) - Primary offer content



### oem_program_name

Official program name assigned by the manufacturer to the incentive offer. Provides standardized program identification for tracking, analysis, and coordination with dealer networks. May be null when OEMs do not assign specific program names.

**Source**: Scraped - Extracted from OEM program documentation and offer metadata

| **Attribute** | **Data Feed** | **API**       |
|---------------|---------------|---------------|
| **Name** | `oem_program_name` | `oem_program_name` |
| **Type** | `string` | `string` |
| **Format** | Variable, typically 10-50 characters; may be null for unnamed programs | Variable, typically 10-50 characters; may be null for unnamed programs |
| **Sample** | `Spring Sales Event` | `Year-End Clearance` |


**API Parameters**

Not available as a search parameter

**See Also**

- [cashback_target_group](#cashback_target_group) - Target customer segments
- [make](#make) - Vehicle manufacturer



### offer_link

Direct URL to the manufacturer's website page containing the original incentive offer. Provides access to the complete offer details and terms.

**Source**: Scraped - Extracted from OEM website offer pages

| **Attribute** | **Data Feed** | **API**       |
|---------------|---------------|---------------|
| **Name** | `offer_link` | `offer_link` |
| **Type** | `string` | `string` |
| **Format** | Valid URL format (http/https) | Valid URL format (http/https) |
| **Sample** | `https://www.toyota.com/upstateny/deals-incentives/tundrahybrid_cash_aefbdede-954b-4541-9ac3-99773199316d/?vehicles=tundrahybrid` | `https://www.toyota.com/upstateny/deals-incentives/tundrahybrid_cash_aefbdede-954b-4541-9ac3-99773199316d/?vehicles=tundrahybrid` |


**API Parameters**

Not available as a search parameter

**See Also**

- [source](#source) - Data source identifier
- [offers](#offers) - Primary offer content



### photo_links

Array of image URLs associated with the incentive offer from manufacturer promotional materials. Provides visual content related to the featured vehicles or promotional campaigns.

**Source**: Scraped - Extracted from OEM website offer pages

| **Attribute** | **Data Feed** | **API**       |
|---------------|---------------|---------------|
| **Name** | `photo_links` | `photo_links` |
| **Type** | `string` | `array<string>` |
| **Format** | Multiple URLs separated by pipe (|) character | Array of strings, each representing a valid URL |
| **Sample** | `https://www.kia.com/us/content/dam/kia/us/en/vehicles/niro-ev/2025/trims/wave/exterior/d7d7d7/360/35.png|https://www.kia.com/us/content/dam/kia/us/en/vehicles/niro-ev/2025/trims/wind/exterior/d7d7d7/360/35.png` | `["https://www.kia.com/us/content/dam/kia/us/en/vehicles/niro-ev/2025/trims/wave/exterior/d7d7d7/360/35.png", "https://www.kia.com/us/content/dam/kia/us/en/vehicles/niro-ev/2025/trims/wind/exterior/d7d7d7/360/35.png"]` |


**API Parameters**

Not available as a search parameter