Vehicle Listing

Access comprehensive vehicle listings with detailed specifications and pricing

GET Request

~500ms response

1 credit per request

Endpoint

GET https://api.carapi.dev/v1/listing

Parameters

Parameter	Type	Required	Description
make	string	Optional	Filter by vehicle manufacturer (partial match)
model	string	Optional	Filter by vehicle model (partial match)
year	number	Optional	Filter by registration year (exact match)
limit	number	Optional	Number of results per page (default: 10, max: 50)
offset	number	Optional	Starting position for pagination (default: 0, max: 10000)
token	string	Required	API authentication token (query parameter)

Supported Makes

Acura, Alfa Romeo, Audi, BMW, Cadillac, Chevrolet, Citroën, Cupra, Dacia, Dodge, Ferrari, Fiat, Ford, GMC, Honda, Hyundai, Jaguar, Jeep, Kia, Land Rover, Lexus, Mazda, Mercedes-Benz, MG, MINI, Mitsubishi, Nissan, Opel, Peugeot, Porsche, Ram, Renault, SEAT, Škoda, Subaru, Suzuki, Tesla, Toyota, Volvo, VW

40 makes supported with 500+ models. Try the API Playground for the full searchable list.

Request Examples

cURL

curl -X GET \
  "https://api.carapi.dev/v1/listing?make=Honda&limit=5&token=YOUR_API_KEY"

JavaScript

// Using fetch API
const response = await fetch('https://api.carapi.dev/v1/listing?make=Honda&limit=5&token=YOUR_API_KEY', {
  method: 'GET',
  headers: {
    'Content-Type': 'application/json'
  }
});

const data = await response.json();
console.log(data);

Python

import requests

url = "https://api.carapi.dev/v1/listing"
params = {
    "make": "Honda",
    "limit": "5",
    "token": "YOUR_API_KEY"
}

response = requests.get(url, params=params)
data = response.json()
print(data)

Response Examples

Success Response (200)

{
  "listings": [
    {
      "vin": "19XFL1H76RE001117",
      "specifications": {
        "make": "Honda",
        "model": "Civic",
        "fuel": "petrol",
        "transmission": "automatic",
        "registrationDate": "2024-01-01T00:00:00.000Z"
      },
      "availability": {
        "imagesCount": 0,
        "plateNumbersCount": 1,
        "historyItemsCount": 1
      }
    }
  ],
  "pagination": {
    "limit": 5,
    "offset": 0
  }
}

Error Response (500)

{
  "error": "Internal server error"
}

Response Fields

Field	Type	Description
listings	array	Array of vehicle listing objects
listings[].vin	string	Vehicle Identification Number
listings[].specifications	object	Vehicle specifications
listings[].specifications.make	string	Vehicle manufacturer
listings[].specifications.model	string	Vehicle model
listings[].specifications.fuel	string\|null	Fuel type (e.g., "petrol", "diesel", "electric")
listings[].specifications.transmission	string\|null	Transmission type (e.g., "manual", "automatic")
listings[].specifications.registrationDate	string	Registration date (ISO format)
listings[].availability	object	Data availability counts
listings[].availability.imagesCount	number	Number of available images
listings[].availability.plateNumbersCount	number	Number of plate number records
listings[].availability.historyItemsCount	number	Number of history records
pagination	object	Pagination information
pagination.limit	number	Number of records per page
pagination.offset	number	Starting offset for current page

Error Codes

403

Forbidden

Invalid or missing API token

500

Internal Server Error

Server encountered an error processing the request

Important Notes

•Results are ordered by creation date (most recent first)
•Make and model filters support partial matching (case-insensitive)
•Default limit is 10 records, maximum is 50 per request
•Use pagination (limit/offset) for large result sets
•Each successful request consumes 1 API credit from your monthly allowance
•Response data is cached for improved performance