Car API
Welcome to [CarAPIs vehicle API](https://carapi.app) documentation. The developer friendly Car API. Start developing with your vehicle API today — no fees, no signup. CarAPIs free vehicle data-set requires no account. Only pay when you're ready to go live. The free data-set is limited to 2015-2020 vehicles. To access the full data-set you may [signup here](https://carapi.app/register) and then select a subscription plan. **Additional Documentation** For additional documentation please review [https://carapi.app/docs](https://carapi.app/docs). **SDKs** PHP SDK: [https://github.com/car-api-team/
What You Can Do
MCP Tools
account-requests-get
Car API Get API Usage
account-requeststoday-get
Car API Get Today's API Usage
auth-api-post
Car API JWT Login
makemodeltrimbodies-index-get
Car API Search vehicle bodies
datafeeds-download-get
Car API Get Data Feed
datafeeds-lastupdated-get
Car API Data Feed Last Updated
makemodeltrimengines-index-get
Car API Search vehicle engines
makemodeltrimexteriorcolors-index-get
Car API Search vehicle exterior colors
makemodeltriminteriorcolors-index-get
Car API Search vehicle interior colors
makes-index-get
Car API Get Makes
makemodeltrimmileages-index-get
Car API Search vehicle mileages
makemodels-index-get
Car API Get Models
makemodeltrims-index-get
Car API Search trims
makemodeltrims-view-get
Car API Get vehicle data.
vehicleattributes-display-get
Car API Get Vehicle Attributes
vindecoder-index-get
Car API Vin Decoder
years-index-get
Car API Get Years List
Capability Spec
naftiko: 1.0.0-alpha2
info:
label: Car API
description: 'Welcome to [CarAPIs vehicle API](https://carapi.app) documentation. The developer friendly Car API. Start
developing with your vehicle API today — no fees, no signup. CarAPIs free vehicle data-set requires no account. Only pay
when you''re ready to go live. The free data-set is limited to 2015-2020 vehicles. To access the full data-set you may
[signup here](https://carapi.app/register) and then select a subscription plan. **Additional Documentation** For additional
documentation please review [https://carapi.app/docs](https://carapi.app/docs). **SDKs** PHP SDK: [https://github.com/car-api-team/'
tags:
- Car
- Api
- API
created: '2026-05-06'
modified: '2026-05-06'
capability:
consumes:
- type: http
namespace: car-api
baseUri: https://carapi.app
description: Car API HTTP API.
authentication:
type: bearer
token: '{{CAR_API_TOKEN}}'
resources:
- name: api-account-requests
path: /api/account/requests
operations:
- name: account-requests-get
method: GET
description: Car API Get API Usage
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
- name: api-account-requests-today
path: /api/account/requests-today
operations:
- name: account-requeststoday-get
method: GET
description: Car API Get Today's API Usage
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
- name: api-auth-login
path: /api/auth/login
operations:
- name: auth-api-post
method: POST
description: Car API JWT Login
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
- name: api-bodies
path: /api/bodies
operations:
- name: makemodeltrimbodies-index-get
method: GET
description: Car API Search vehicle bodies
inputParameters:
- name: sort
in: query
type: string
- name: verbose
in: query
type: string
description: Includes make, model and trim
- name: make_model_id
in: query
type: string
- name: make_id
in: query
type: string
- name: year
in: query
type: string
- name: make
in: query
type: string
- name: model
in: query
type: string
- name: trim
in: query
type: string
- name: make_model_trim_id
in: query
type: string
- name: type
in: query
type: string
- name: doors
in: query
type: string
- name: json
in: query
type: string
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
- name: api-data-feeds-download
path: /api/data-feeds/download
operations:
- name: datafeeds-download-get
method: GET
description: Car API Get Data Feed
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
- name: api-data-feeds-last-updated
path: /api/data-feeds/last-updated
operations:
- name: datafeeds-lastupdated-get
method: GET
description: Car API Data Feed Last Updated
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
- name: api-engines
path: /api/engines
operations:
- name: makemodeltrimengines-index-get
method: GET
description: Car API Search vehicle engines
inputParameters:
- name: sort
in: query
type: string
- name: verbose
in: query
type: string
description: Includes make, model and trim
- name: make_model_trim_id
in: query
type: string
- name: cylinders
in: query
type: string
- name: size
in: query
type: string
- name: horsepower_hp
in: query
type: string
- name: valves
in: query
type: string
- name: valve_timing
in: query
type: string
- name: cam_type
in: query
type: string
- name: drive_type
in: query
type: string
- name: transmission
in: query
type: string
- name: engine_type
in: query
type: string
- name: fuel_type
in: query
type: string
- name: make_model_id
in: query
type: string
- name: make_id
in: query
type: string
- name: year
in: query
type: string
- name: make
in: query
type: string
- name: model
in: query
type: string
- name: trim
in: query
type: string
- name: json
in: query
type: string
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
- name: api-exterior-colors
path: /api/exterior-colors
operations:
- name: makemodeltrimexteriorcolors-index-get
method: GET
description: Car API Search vehicle exterior colors
inputParameters:
- name: sort
in: query
type: string
- name: verbose
in: query
type: string
description: Includes make, model and trim
- name: make_model_trim_id
in: query
type: string
- name: make_model_id
in: query
type: string
- name: make_id
in: query
type: string
- name: name
in: query
type: string
- name: rgb
in: query
type: string
- name: year
in: query
type: string
- name: make
in: query
type: string
- name: model
in: query
type: string
- name: trim
in: query
type: string
- name: json
in: query
type: string
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
- name: api-interior-colors
path: /api/interior-colors
operations:
- name: makemodeltriminteriorcolors-index-get
method: GET
description: Car API Search vehicle interior colors
inputParameters:
- name: sort
in: query
type: string
- name: verbose
in: query
type: string
description: Includes make, model and trim
- name: make_model_trim_id
in: query
type: string
- name: make_model_id
in: query
type: string
- name: make_id
in: query
type: string
- name: name
in: query
type: string
- name: rgb
in: query
type: string
- name: year
in: query
type: string
- name: make
in: query
type: string
- name: model
in: query
type: string
- name: trim
in: query
type: string
- name: json
in: query
type: string
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
- name: api-makes
path: /api/makes
operations:
- name: makes-index-get
method: GET
description: Car API Get Makes
inputParameters:
- name: sort
in: query
type: string
- name: make
in: query
type: string
- name: year
in: query
type: string
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
- name: api-mileages
path: /api/mileages
operations:
- name: makemodeltrimmileages-index-get
method: GET
description: Car API Search vehicle mileages
inputParameters:
- name: sort
in: query
type: string
- name: verbose
in: query
type: string
description: Includes make, model and trim
- name: make_model_trim_id
in: query
type: string
- name: combined_mpg
in: query
type: string
- name: epa_city_mpg
in: query
type: string
- name: epa_highway_mpg
in: query
type: string
- name: range_city
in: query
type: string
- name: range_highway
in: query
type: string
- name: make_model_id
in: query
type: string
- name: make_id
in: query
type: string
- name: year
in: query
type: string
- name: make
in: query
type: string
- name: model
in: query
type: string
- name: trim
in: query
type: string
- name: json
in: query
type: string
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
- name: api-models
path: /api/models
operations:
- name: makemodels-index-get
method: GET
description: Car API Get Models
inputParameters:
- name: sort
in: query
type: string
- name: verbose
in: query
type: string
description: Includes make and model
- name: year
in: query
type: string
- name: make
in: query
type: string
- name: model
in: query
type: string
- name: make_id
in: query
type: string
- name: json
in: query
type: string
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
- name: api-trims
path: /api/trims
operations:
- name: makemodeltrims-index-get
method: GET
description: Car API Search trims
inputParameters:
- name: sort
in: query
type: string
- name: verbose
in: query
type: string
description: Includes make, model and trim
- name: year
in: query
type: string
- name: make
in: query
type: string
- name: model
in: query
type: string
- name: trim
in: query
type: string
- name: make_model_id
in: query
type: string
- name: make_id
in: query
type: string
- name: json
in: query
type: string
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
- name: api-trims-id
path: /api/trims/{id}
operations:
- name: makemodeltrims-view-get
method: GET
description: Car API Get vehicle data.
inputParameters:
- name: id
in: path
type: integer
required: true
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
- name: api-vehicle-attributes
path: /api/vehicle-attributes
operations:
- name: vehicleattributes-display-get
method: GET
description: Car API Get Vehicle Attributes
inputParameters:
- name: attribute
in: query
type: string
description: The attribute options to be returned
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
- name: api-vin-vin
path: /api/vin/{vin}
operations:
- name: vindecoder-index-get
method: GET
description: Car API Vin Decoder
inputParameters:
- name: vin
in: path
type: string
required: true
- name: verbose
in: query
type: string
description: 'Includes body, engine, and mileage data (default: no)'
- name: all_trims
in: query
type: string
description: 'Includes all trims for the matching model (default: no)'
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
- name: api-years
path: /api/years
operations:
- name: years-index-get
method: GET
description: Car API Get Years List
inputParameters:
- name: year
in: query
type: string
- name: make
in: query
type: string
- name: model
in: query
type: string
- name: trim
in: query
type: string
- name: make_model_id
in: query
type: string
- name: make_id
in: query
type: string
- name: json
in: query
type: string
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
exposes:
- type: rest
port: 8080
namespace: car-api-rest
description: REST adapter for Car API.
resources:
- path: /api/account/requests
name: account-requests-get
operations:
- method: GET
name: account-requests-get
description: Car API Get API Usage
call: car-api.account-requests-get
outputParameters:
- type: object
mapping: $.
- path: /api/account/requests-today
name: account-requeststoday-get
operations:
- method: GET
name: account-requeststoday-get
description: Car API Get Today's API Usage
call: car-api.account-requeststoday-get
outputParameters:
- type: object
mapping: $.
- path: /api/auth/login
name: auth-api-post
operations:
- method: POST
name: auth-api-post
description: Car API JWT Login
call: car-api.auth-api-post
outputParameters:
- type: object
mapping: $.
- path: /api/bodies
name: makemodeltrimbodies-index-get
operations:
- method: GET
name: makemodeltrimbodies-index-get
description: Car API Search vehicle bodies
call: car-api.makemodeltrimbodies-index-get
outputParameters:
- type: object
mapping: $.
- path: /api/data-feeds/download
name: datafeeds-download-get
operations:
- method: GET
name: datafeeds-download-get
description: Car API Get Data Feed
call: car-api.datafeeds-download-get
outputParameters:
- type: object
mapping: $.
- path: /api/data-feeds/last-updated
name: datafeeds-lastupdated-get
operations:
- method: GET
name: datafeeds-lastupdated-get
description: Car API Data Feed Last Updated
call: car-api.datafeeds-lastupdated-get
outputParameters:
- type: object
mapping: $.
- path: /api/engines
name: makemodeltrimengines-index-get
operations:
- method: GET
name: makemodeltrimengines-index-get
description: Car API Search vehicle engines
call: car-api.makemodeltrimengines-index-get
outputParameters:
- type: object
mapping: $.
- path: /api/exterior-colors
name: makemodeltrimexteriorcolors-index-get
operations:
- method: GET
name: makemodeltrimexteriorcolors-index-get
description: Car API Search vehicle exterior colors
call: car-api.makemodeltrimexteriorcolors-index-get
outputParameters:
- type: object
mapping: $.
- path: /api/interior-colors
name: makemodeltriminteriorcolors-index-get
operations:
- method: GET
name: makemodeltriminteriorcolors-index-get
description: Car API Search vehicle interior colors
call: car-api.makemodeltriminteriorcolors-index-get
outputParameters:
- type: object
mapping: $.
- path: /api/makes
name: makes-index-get
operations:
- method: GET
name: makes-index-get
description: Car API Get Makes
call: car-api.makes-index-get
outputParameters:
- type: object
mapping: $.
- path: /api/mileages
name: makemodeltrimmileages-index-get
operations:
- method: GET
name: makemodeltrimmileages-index-get
description: Car API Search vehicle mileages
call: car-api.makemodeltrimmileages-index-get
outputParameters:
- type: object
mapping: $.
- path: /api/models
name: makemodels-index-get
operations:
- method: GET
name: makemodels-index-get
description: Car API Get Models
call: car-api.makemodels-index-get
outputParameters:
- type: object
mapping: $.
- path: /api/trims
name: makemodeltrims-index-get
operations:
- method: GET
name: makemodeltrims-index-get
description: Car API Search trims
call: car-api.makemodeltrims-index-get
outputParameters:
- type: object
mapping: $.
- path: /api/trims/{id}
name: makemodeltrims-view-get
operations:
- method: GET
name: makemodeltrims-view-get
description: Car API Get vehicle data.
call: car-api.makemodeltrims-view-get
with:
id: rest.id
outputParameters:
- type: object
mapping: $.
- path: /api/vehicle-attributes
name: vehicleattributes-display-get
operations:
- method: GET
name: vehicleattributes-display-get
description: Car API Get Vehicle Attributes
call: car-api.vehicleattributes-display-get
outputParameters:
- type: object
mapping: $.
- path: /api/vin/{vin}
name: vindecoder-index-get
operations:
- method: GET
name: vindecoder-index-get
description: Car API Vin Decoder
call: car-api.vindecoder-index-get
with:
vin: rest.vin
outputParameters:
- type: object
mapping: $.
- path: /api/years
name: years-index-get
operations:
- method: GET
name: years-index-get
description: Car API Get Years List
call: car-api.years-index-get
outputParameters:
- type: object
mapping: $.
- type: mcp
port: 9090
namespace: car-api-mcp
transport: http
description: MCP adapter for Car API for AI agent use.
tools:
- name: account-requests-get
description: Car API Get API Usage
hints:
readOnly: true
destructive: false
idempotent: true
call: car-api.account-requests-get
outputParameters:
- type: object
mapping: $.
- name: account-requeststoday-get
description: Car API Get Today's API Usage
hints:
readOnly: true
destructive: false
idempotent: true
call: car-api.account-requeststoday-get
outputParameters:
- type: object
mapping: $.
- name: auth-api-post
description: Car API JWT Login
hints:
readOnly: false
destructive: false
idempotent: false
call: car-api.auth-api-post
outputParameters:
- type: object
mapping: $.
- name: makemodeltrimbodies-index-get
description: Car API Search vehicle bodies
hints:
readOnly: true
destructive: false
idempotent: true
call: car-api.makemodeltrimbodies-index-get
with:
sort: tools.sort
verbose: tools.verbose
make_model_id: tools.make_model_id
make_id: tools.make_id
year: tools.year
make: tools.make
model: tools.model
trim: tools.trim
make_model_trim_id: tools.make_model_trim_id
type: tools.type
doors: tools.doors
json: tools.json
inputParameters:
- name: sort
type: string
description: sort
- name: verbose
type: string
description: Includes make, model and trim
- name: make_model_id
type: string
description: make_model_id
- name: make_id
type: string
description: make_id
- name: year
type: string
description: year
- name: make
type: string
description: make
- name: model
type: string
description: model
- name: trim
type: string
description: trim
- name: make_model_trim_id
type: string
description: make_model_trim_id
- name: type
type: string
description: type
- name: doors
type: string
description: doors
- name: json
type: string
description: json
outputParameters:
- type: object
mapping: $.
- name: datafeeds-download-get
description: Car API Get Data Feed
hints:
readOnly: true
destructive: false
idempotent: true
call: car-api.datafeeds-download-get
outputParameters:
- type: object
mapping: $.
- name: datafeeds-lastupdated-get
description: Car API Data Feed Last Updated
hints:
readOnly: true
destructive: false
idempotent: true
call: car-api.datafeeds-lastupdated-get
outputParameters:
- type: object
mapping: $.
- name: makemodeltrimengines-index-get
description: Car API Search vehicle engines
hints:
readOnly: true
destructive: false
idempotent: true
call: car-api.makemodeltrimengines-index-get
with:
sort: tools.sort
verbose: tools.verbose
make_model_trim_id: tools.make_model_trim_id
cylinders: tools.cylinders
size: tools.size
horsepower_hp: tools.horsepower_hp
valves: tools.valves
valve_timing: tools.valve_timing
cam_type: tools.cam_type
drive_type: tools.drive_type
transmission: tools.transmission
engine_type: tools.engine_type
fuel_type: tools.fuel_type
make_model_id: tools.make_model_id
make_id: tools.make_id
year: tools.year
make: tools.make
model: tools.model
trim: tools.trim
json: tools.json
inputParameters:
- name: sort
type: string
description: sort
- name: verbose
type: string
description: Includes make, model and trim
- name: make_model_trim_id
type: string
description: make_model_trim_id
- name: cylinders
type: string
description: cylinders
- name: size
type: string
description: size
- name: horsepower_hp
type: string
description: horsepower_hp
- name: valves
type: string
description: valves
- name: valve_timing
type: string
description: valve_timing
- name: cam_type
type: string
description: cam_type
- name: drive_type
type: string
description: drive_type
- name: transmission
type: string
description: transmission
- name: engine_type
type: string
description: engine_type
- name: fuel_type
type: string
description: fuel_type
- name: make_model_id
type: string
description: make_model_id
- name: make_id
type: string
description: make_id
- name: year
type: string
description: year
- name: make
type: string
description: make
- name: model
type: string
description: model
- name: trim
type: string
description: trim
- name: json
type: string
description: json
outputParameters:
- type: object
mapping: $.
- name: makemodeltrimexteriorcolors-index-get
description: Car API Search vehicle exterior colors
hints:
readOnly: true
destructive: false
idempotent: true
call: car-api.makemodeltrimexteriorcolors-index-get
with:
sort: tools.sort
verbose: tools.verbose
make_model_trim_id: tools.make_model_trim_id
make_model_id: tools.make_model_id
make_id: tools.make_id
name: tools.name
rgb: tools.rgb
year: tools.year
make: tools.make
model: tools.model
trim: tools.trim
json: tools.json
inputParameters:
- name: sort
type: string
description: sort
- name: verbose
type: string
description: Includes make, model and trim
- name: make_model_trim_id
type: string
description: make_model_trim_id
- name: make_model_id
type: string
description: make_model_id
- name: make_id
type: string
description: make_id
- name: name
type: string
description: name
- name: rgb
type: string
description: rgb
- name: year
type: string
description: year
- name: make
type: string
description: make
- name: model
type: string
description: model
- name: trim
type: string
description: trim
- name: json
type: string
description: json
outputParameters:
- type: object
mapping: $.
- name: makemodeltriminteriorcolors-index-get
description: Car API Search vehicle interior colors
hints:
readOnly: true
destructive: false
idempotent: true
call: car-api.makemodeltriminteriorcolors-index-get
with:
sort: tools.sort
verbose: tools.verbose
make_model_trim_id: tools.make_model_trim_id
make_model_id: tools.make_model_id
make_id: tools.make_id
name: tools.name
rgb: tools.rgb
year: tools.year
make: tools.make
model: tools.model
trim: tools.trim
json: tools.json
inputParameters:
- name: sort
type: string
description: sort
- name: verbose
type: string
description: Includes make, model and trim
- name: make_model_trim_id
type: string
description: make_model_trim_id
- name: make_model_id
type: string
description: make_model_id
- name: make_id
type: string
description: make_id
- name: name
type: string
description: name
- name: rgb
type: string
description: rgb
- name: year
type: string
description: year
- name: make
type: string
description: make
- name: model
type: string
description: model
- name: trim
type: string
description: trim
- name: json
type: string
description: json
outputParameters:
- type: object
mapping: $.
- name: makes-index-get
description: Car API Get Makes
hints:
readOnly: true
destructive: false
idempotent: true
call: car-api.makes-index-get
with:
sort: tools.sort
make: tools.make
year: tools.year
inputParameters:
- name: sort
type: string
description: sort
- name: make
type: string
description: make
- name: year
type: string
description: year
outputParameters:
- type: object
mapping: $.
- name: makemodeltrimmileages-index-get
description: Car API Search vehicle mileages
hints:
readOnly: true
destructive: false
idempotent: true
call: car-api.makemodeltrimmileages-index-get
with:
sort: tools.sort
verbose: tools.verbose
make_model_trim_id: tools.make_model_trim_id
combined_mpg: tools.combined_mpg
epa_city_mpg: tools.epa_city_mpg
epa_highway_mpg: tools.epa_highway_mpg
range_city: tools.range_city
range_highway: tools.range_highway
make_model_id: tools.make_model_id
make_id: tools.make_id
year: tools.year
make: tools.make
model: tools.model
trim: tools.trim
json: tools.json
inputParameters:
- name: sort
type: string
description: sort
- name: verbose
type: string
description: Includes make, model and trim
- name: make_model_trim_id
type: string
description: make_model_trim_id
- name: combined_mpg
type: string
description: combined_mpg
- name: epa_city_mpg
type: string
description: epa_city_mpg
- name: epa_highway_mpg
type: string
description: epa_highway_mpg
- name: range_city
type: string
description: range_city
- name: range_highway
type: string
description: range_highway
- name: make_model_id
type: string
description: make_model_id
- name: make_id
type: string
description: make_id
- name: year
type: string
description: year
- name: make
type: string
description: make
- name: model
type: string
description: model
- name: trim
type: string
description: trim
- name: json
type: string
description: json
outputParameters:
- type: object
mapping: $.
- name: makemodels-index-get
description: Car API Get Models
hints:
readOnly: true
destructive: false
idempotent: true
call: car-api.makemodels-index-get
with:
sort: tools.sort
verbose: tools.verbose
year: tools.year
make: tools.make
model: tools.model
make_id: tools.make_id
json: tools.json
inputParameters:
- name: sort
type: string
description: sort
- name: verbose
type: string
description: Includes make and model
- name: year
type: string
description: year
- name: make
type: string
description: make
- name: model
type: string
description: model
- name: make_id
type: string
description: make_id
- name: json
type: string
description: json
outputParameters:
- type: object
mapping: $.
- name: makemodeltrims-index-get
description: Car API Search trims
hints:
readOnly: true
destructive: false
idempotent: true
call: car-api.makemodeltrims-index-get
with:
sort: tools.sort
verbose: tools.verbose
year: tools.year
make: tools.make
model: tools.model
trim: tools.trim
make_model_id: tools.make_model_id
make_id: tools.make_id
json: tools.json
inputParameters:
- name: sort
type: string
description: sort
- name: verbose
type: string
description: Includes make, model and trim
- name: year
type: string
description: year
- name: make
type: string
description: make
- name: model
type: string
description: model
- name: trim
type: string
description: trim
- name: make_model_id
type: string
description: make_model_id
- name: make_id
type: string
# --- truncated at 32 KB (34 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/car-api/refs/heads/main/capabilities/car-api-capability.yaml