The Motor Intelligence API
The Motor Intelligence System (MIS) can be accessed via HTTP queries for direct integration withyour business intelligence systems and dashboards.
Please refer to your contract or email info@motorintelligence.com for any restrictions such as
datasets, number of historical months or monthly caps for direct API queries. If you require anMI API access key, please email info@motorintelligence.com.
Communication to and from the Motor Intelligence API is done through HTTP GET or POST
requests. The MI API currently supports JSON and CSV data response formats.

Request Parameters:
Data recovery is done via very simple GET or POST requests to motorintelligence.com/api/.
This means you can specify all the information and options directly into the url and easily test
using your browser without writing any code. For seamless filtering, all query filters available inthe browser-based query are available to API users.
To access the query, you must use your API Key along with any filters in each request.
For your reference, examples of querying each of the datasets and theirrequired/optional/default values are included in this document.

HTTP Error 403.0 – Forbidden Access:Any request with invalid credentials (Access ID or Data Set) will receive an HTTP 403.0 Forbiddenerror. All other errors will return an error string noting the invalid parameter.
Access Suspensions:Your query permissions mimic those in your MIS account. Your account may be suspended if
Motor Intelligence suspects account abuse (abnormally frequent queries, requests from multiple
different domains, etc…). You will receive a 403.0 Forbidden response when your account issuspended.

2Sales, Cost & Inventory
Example: Most Recent Month of Sales, Cost & Inventory
http://motorintelligence.com/api/?Key=[YOUR_API_KEY]&QueryType=SalesCostInventory&Map
Name=[CUSTOM_MAP_NAME]&DataSet=New Sales,Program Cost,Inventory
Valid HTTP parameters include:
Parameter
Key
QueryType
DataSetStartDate*

Valid ValuesYour API ACCESS KEY
SalesCostInventory
Comma separated list of one or more datasets:
1. New Sales
2. Market Share
3. Daily Average
4. CPO Sales
5. Inventory
6. Days Supply
7. Program Cost
8. Program Cost DetailCustom map name (used in your online query)
Desired output format:
1. CSV
2. JSON
Start date

EndDate*End date

MapName
TypeClassRequired
Required
Required
Required

Required
Optional

Optional
Optional

Default

CSV

First day of lastavailable month
Last day of lastavailable month
Empty = Both Car &Truck

Comma separated list of class:
Optional
1. Car
2. Truck
Segment
One or more comma separated segments
Optional
Empty = All Segments
BrandModel
One or more comma separated brand or model
Optional
Empty = All Brands &names
Models
DatePivot
One or more comma separated model names:
Optional
None
1. None*2. Month3. Quarter
4. Year* When querying the Market Share & Program
Cost Detail datasets, Date Pivot must be ‘None’.
*The StartDate and EndDate may automatically adjust based on your permissions or the last available month in MIS
if you exceed it. Check the StartDate & EndDate in HTTP Response Header to see if they were adjusted.

3

SAAR
Example: Most Recent Month of SAAR
http://motorintelligence.com/api/?Key=[YOUR_API_KEY]&QueryType=SAAR
Valid HTTP parameters include:Parameter
KeyQueryType
Type

StartDate*Valid ValuesYour API ACCESS KEYSAAR
Desired output format:
1. CSV
2. JSON
Start dateRequired
Required
Required
Optional

Default

CSV

Optional

First day of lastavailable month
EndDate*End date
Optional
Last day of lastavailable month*The StartDate and EndDate may automatically adjust based on your permissions or the last available month in MIS
if you exceed it. Check the StartDate & EndDate in HTTP Response Header to see if they were adjusted.

4

Programs
Example: Current Month of National Program Incentives
http://motorintelligence.com/api/?Key=[YOUR_API_KEY]&QueryType=Incentives
Valid HTTP parameters include:ParameterKeyQueryType
MapNameType

Required
Required
Required
Required
Optional

StartDate*

Valid ValuesYour API ACCESS KEY
Incentives
Custom map name (used in your online query)
Desired output format:
1. CSV
2. JSON
Start date

EndDate*End date

Optional

VehicleType

Optional

Default

CSV

First day of current
month
Last day of current
month
New

Comma separated list of class:
Optional
1. New
2. PreOwned
Regional
One or more comma separated manufacturer
Optional
Empty = All Regions
regions
BrandModel
One or more comma separated brand or model
Optional
Empty = All Brands &namesModels*The StartDate and EndDate may automatically adjust based on your permissions or if you query more than 1month. Check the StartDate & EndDate in HTTP Response Header to see if they were adjusted.

5APR
Example: Current Month of National APR Incentives
http://motorintelligence.com/api/?Key=[YOUR_API_KEY]&QueryType=APR
Valid HTTP parameters include:
Parameter
Key
QueryType
MapNameType

Required
Required
Required
Required
Optional

StartDate

Valid ValuesYour API ACCESS KEY
APRCustom map name (used in your online query)
Desired output format:
1. CSV
2. JSONStart date

EndDateEnd date

Optional

VehicleType

Optional

Default

CSV

First day of current
month
Last day of current
monthNew

Comma separated list of class:
Optional
1. New
2. PreOwned
Regional
National or Regional:
Optional
False (National)
1. False – National
2. True - Regional
RegionOne or more comma separated manufacturer
Optional
Empty = All Regions
regions
BrandModel
One or more comma separated brand or model
Optional
Empty = All Brands &names
Models*The StartDate and EndDate may automatically adjust based on your permissions or if you query more than 1month. Check the StartDate & EndDate in HTTP Response Header to see if they were adjusted.

6RESIDUALS / MONEY FACTORS
Example: Current Month of Residuals & Money Factors
http://motorintelligence.com/api/?Key=b6f983d8-a667-4c74-b545b0c4ae4eeb1e&QueryType=RMF
Valid HTTP parameters include:
Parameter
Key
QueryType
MapNameType

Required
Required
Required
Required
Optional

StartDate

Valid ValuesYour API ACCESS KEY
RMF
Custom map name (used in your online query)
Desired output format:
1. CSV
2. JSON
Start date

EndDateEnd date

Optional

RegionOptionalDefault

CSVFirst day of current
month
Last day of current
month
Empty = All Regions

One or more comma separated manufacturer
Optional
regions
BrandModel
One or more comma separated brand or model
Optional
Empty = All Brands &names
Models*The StartDate and EndDate may automatically adjust based on your permissions or if you query more than 1month. Check the StartDate & EndDate in HTTP Response Header to see if they were adjusted.

7

PRICE POINTS
Example: Current Month of Residuals & Money Factors
http://motorintelligence.com/api/?Key=[YOUR_API_KEY]&QueryType=RMF
Valid HTTP parameters include:
Parameter
Key
QueryType
MapNameType

Required
Required
Required
Required
Optional

StartDate

Valid ValuesYour API ACCESS KEY
PricePoints
Custom map name (used in your online query)
Desired output format:
1. CSV
2. JSON
Start date

EndDateEnd date

Optional

RegionOptional

Default

CSV

First day of current
month
Last day of current
month
Empty = All Regions

One or more comma separated manufacturer
Optional
regions
BrandModel
One or more comma separated brand or model
Optional
Empty = All Brands &names
Models*The StartDate and EndDate may automatically adjust based on your permissions or if you query more than 1month. Check the StartDate & EndDate in HTTP Response Header to see if they were adjusted.

8