Vehicle — entry 009 of 10
RevCarData
RevCarData is a global Year-Make-Model-Trim vehicle database covering EU, US, and Asian markets, exposing 53 structured spec fields per trim — MSRP, powertrain, dimensions, and EV/battery metrics — via a REST API and CSV export. Its own OpenAPI spec puts the index at 455,000+ vehicle configurations, and a live GET against /health in this run confirmed 452,662 rows loaded. A live GET against its real API host, api.revcardata.com/api/v1/vehicles, returned a 401 "Missing X-API-Key header" error carrying access-control-allow-origin: * — reconfirming auth "API Key" and cors "yes" — over HTTPS. Its site offers a free sign-up-and-get-a-key tier alongside paid plans for higher volume — freemium.
GreatAPIs Score
Auth quickstart
- Sign up with the provider to get an API key.
- Send it on every request as a header
X-API-Key: <key>
Your key is stored only in this browser (localStorage) and sent directly to the API — never to greatapis.
Endpoints
1. Search & Listing1
Search the global database by YMMT and physical parameters.
GET/api/v1/vehiclesSearch Vehicles
| Name | In | Required | Type |
|---|---|---|---|
make | query | no | string |
model | query | no | string |
year | query | no | integer |
trim | query | no | string |
body_type | query | no | string |
fuel_type | query | no | string |
region | query | no | string |
min_hp | query | no | integer |
min_ev_range_km | query | no | integer |
max_acceleration_0_100 | query | no | number |
trim_exact | query | no | boolean |
q | query | no | string |
limit | query | no | integer |
skip | query | no | integer |
| Status | Description | Schema |
|---|---|---|
200 | Successful Response | SearchResponse |
401 | Unauthorized - Invalid API Key | ErrorResponse |
422 | Validation Error | HTTPValidationError |
429 | Too Many Requests - Quota Exceeded | ErrorResponse |
2. Core Specs1
Engine, transmission and drivetrain specs.
GET/api/v1/vehicles/{vehicle_id}/coreGet Core Specs
| Name | In | Required | Type |
|---|---|---|---|
vehicle_id | path | yes | integer |
| Status | Description | Schema |
|---|---|---|
200 | Successful Response | CoreResponse |
401 | Unauthorized - Invalid API Key | ErrorResponse |
404 | Not Found | ErrorResponse |
422 | Validation Error | HTTPValidationError |
429 | Too Many Requests - Quota Exceeded | ErrorResponse |
3. Premium Specs1
MSRP, dimensions, EV ranges, performance.
GET/api/v1/vehicles/{vehicle_id}/premiumGet Premium Specs
| Name | In | Required | Type |
|---|---|---|---|
vehicle_id | path | yes | integer |
| Status | Description | Schema |
|---|---|---|
200 | Successful Response | PremiumResponse |
401 | Unauthorized - Invalid API Key | ErrorResponse |
404 | Not Found | ErrorResponse |
422 | Validation Error | HTTPValidationError |
429 | Too Many Requests - Quota Exceeded | ErrorResponse |
4. Media & Images1
[COMING SOON]
GET/api/v1/vehicles/{vehicle_id}/images[COMING SOON] Get Vehicle Images
| Name | In | Required | Type |
|---|---|---|---|
vehicle_id | path | yes | integer |
| Status | Description | Schema |
|---|---|---|
200 | Successful Response | — |
422 | Validation Error | HTTPValidationError |
5. Dropdown Helpers9
Dynamic lists for UI selectors.
GET/api/v1/body-typesGet Body Types
| Status | Description | Schema |
|---|---|---|
200 | Successful Response | ListResponse |
401 | Unauthorized - Invalid API Key | ErrorResponse |
429 | Too Many Requests - Quota Exceeded | ErrorResponse |
GET/api/v1/drivetrainsGet Drivetrains
| Status | Description | Schema |
|---|---|---|
200 | Successful Response | ListResponse |
401 | Unauthorized - Invalid API Key | ErrorResponse |
429 | Too Many Requests - Quota Exceeded | ErrorResponse |
GET/api/v1/engine-typesGet Engine Types
| Status | Description | Schema |
|---|---|---|
200 | Successful Response | ListResponse |
401 | Unauthorized - Invalid API Key | ErrorResponse |
429 | Too Many Requests - Quota Exceeded | ErrorResponse |
GET/api/v1/fuel-typesGet Fuel Types
| Status | Description | Schema |
|---|---|---|
200 | Successful Response | ListResponse |
401 | Unauthorized - Invalid API Key | ErrorResponse |
429 | Too Many Requests - Quota Exceeded | ErrorResponse |
GET/api/v1/makesGet Makes
| Status | Description | Schema |
|---|---|---|
200 | Successful Response | ListResponse |
401 | Unauthorized - Invalid API Key | ErrorResponse |
429 | Too Many Requests - Quota Exceeded | ErrorResponse |
GET/api/v1/modelsGet Models
| Name | In | Required | Type |
|---|---|---|---|
make | query | yes | string |
| Status | Description | Schema |
|---|---|---|
200 | Successful Response | ListResponse |
401 | Unauthorized - Invalid API Key | ErrorResponse |
422 | Validation Error | HTTPValidationError |
429 | Too Many Requests - Quota Exceeded | ErrorResponse |
GET/api/v1/transmissionsGet Transmissions
| Status | Description | Schema |
|---|---|---|
200 | Successful Response | ListResponse |
401 | Unauthorized - Invalid API Key | ErrorResponse |
429 | Too Many Requests - Quota Exceeded | ErrorResponse |
GET/api/v1/trimsGet Trims
| Name | In | Required | Type |
|---|---|---|---|
make | query | yes | string |
model | query | yes | string |
year | query | yes | integer |
| Status | Description | Schema |
|---|---|---|
200 | Successful Response | ListResponse |
401 | Unauthorized - Invalid API Key | ErrorResponse |
422 | Validation Error | HTTPValidationError |
429 | Too Many Requests - Quota Exceeded | ErrorResponse |
GET/api/v1/yearsGet Years
| Name | In | Required | Type |
|---|---|---|---|
make | query | yes | string |
model | query | yes | string |
| Status | Description | Schema |
|---|---|---|
200 | Successful Response | IntListResponse |
401 | Unauthorized - Invalid API Key | ErrorResponse |
422 | Validation Error | HTTPValidationError |
429 | Too Many Requests - Quota Exceeded | ErrorResponse |
6. VIN Decoding1
ISO 3779 check-digit validation, WMI → make/country, NHTSA vPIC decode + RevCarData DB enrichment. `include=basic` (free) / `include=premium` / `include=recalls` (region-aware: US→NHTSA, EU→Safety Gate) / `include=history` (paid plans).
GET/api/v1/vehicles/vin/{vin}Decode a VIN (basic = free, premium = paid)
| Name | In | Required | Type |
|---|---|---|---|
vin | path | yes | string |
include | query | no | string |
| Status | Description | Schema |
|---|---|---|
200 | Successful Response | — |
422 | Validation Error | HTTPValidationError |
7. Vehicle History & Reports (EU)2
Official EU registers: RDW Open Data NL (free, no key), DVLA MOT History UK (free key), CEPIK PL. Plate → vehicle identity + history. `POST /vehicles/report` = sellable premium report (VIN or EU plate).
GET/api/v1/vehicles/plate/{plate}Look up a European plate (RDW/DVLA/CEPIK). Free basic / premium history
| Name | In | Required | Type |
|---|---|---|---|
plate | path | yes | string |
country | query | no | string |
source | query | no | string |
wojewodztwo | query | no | string |
include | query | no | string |
| Status | Description | Schema |
|---|---|---|
200 | Successful Response | — |
422 | Validation Error | HTTPValidationError |
POST/api/v1/vehicles/reportPremium vehicle history report (VIN or EU plate). Paid plans only.
application/json — VehicleReportRequest (required)
| Status | Description | Schema |
|---|---|---|
200 | Successful Response | — |
422 | Validation Error | HTTPValidationError |
Authentication2
API key management. Send `X-API-Key` on every request. Free Developer keys available at revcardata.com.
POST/api/v1/auth/claim-free-keyGenerate a Free Developer API Key
application/json — FreeKeyRequest (required)
| Status | Description | Schema |
|---|---|---|
200 | Successful Response | — |
422 | Validation Error | HTTPValidationError |
GET/api/v1/auth/meCurrent customer profile
| Status | Description | Schema |
|---|---|---|
200 | Successful Response | — |
System5
Health checks.
GET/api/v1/changelogProduct changelog (public)
| Name | In | Required | Type |
|---|---|---|---|
limit | query | no | integer |
| Status | Description | Schema |
|---|---|---|
200 | Successful Response | — |
422 | Validation Error | HTTPValidationError |
GET/api/v1/feedbackList feedback (admin)
| Status | Description | Schema |
|---|---|---|
200 | Successful Response | — |
POST/api/v1/feedbackSend feedback / feature request (auth)
application/json — FeedbackRequest (required)
| Status | Description | Schema |
|---|---|---|
200 | Successful Response | — |
422 | Validation Error | HTTPValidationError |
GET/data-qualityPublic data quality report (enterprise trust)
| Status | Description | Schema |
|---|---|---|
200 | Successful Response | — |
GET/healthHealth
| Status | Description | Schema |
|---|---|---|
200 | Successful Response | HealthResponse |
Try it
Developer reference
https://api.revcardata.comFree developer test API key limited to 100 requests/month
- GET/health
- GET/api/v1/changelog
- GET/api/v1/vehicles
- GET/api/v1/makes
Changelog
- gained an OpenAPI spec