powered by apitogoDocumentation
CarBase API
CarBase is a read-only REST API for new US-market cars. It covers model years 2022 to 2025: 46 makes, 443 models, 8,168 trims and more than 109,000 color options.
Use it to build car pickers, comparison tools, search pages and buying guides.
What you can do
- Browse makes, their models and each model's trims
- Search trims by price, body type, engine, fuel economy, EV range, seats and more
- Get full specs for a trim: dimensions, engine, fuel economy, interior room, warranty and expert ratings
- Get a trim's exterior and interior colors with RGB and hex values
- Compare up to five trims side by side
Base URL
Code
All API endpoints are under /api. Every request is a GET and every response is JSON.
Endpoints
| Endpoint | Description |
|---|---|
GET /api/makes | List all makes |
GET /api/makes/{makeId} | Get one make |
GET /api/makes/{makeId}/models | List a make's models |
GET /api/models/{modelId} | Get one model and its model years |
GET /api/models/{modelId}/trims | List a model's trims |
GET /api/trims | Search, filter, sort and page through trims |
GET /api/trims/{id} | Full specs of one trim |
GET /api/trims/{id}/colors | Colors of one trim |
GET /api/compare | Compare 2 to 5 trims |
GET /api/filters | Valid filter values with counts |
GET /api/stats | Dataset statistics |
GET /health | Health check |
GET /openapi.json | OpenAPI 3 spec |
Documentation
- Getting started
- Conventions: IDs, pagination, sorting, units and missing values
- Makes
- Models
- Trims
- Compare
- Reference data
- Errors
- Data dictionary
Last modified on