V1Inventory
List Inventory
Get a paginated list of vehicles in the organization's inventory. Filtering and sorting are optional. Defaults: page=1, limit=10 (max 30), sortField=createdAt, sortDirection=desc. pagination.total reflects the count after filters (or all vehicles if no filters).
AuthorizationBearer <token>
In: header
Scope: *
Query Parameters
page?integer
Page number
Default
1Range
1 <= valuelimit?integer
Items per page (max 30)
Default
10Range
1 <= value <= 30sortField?string
Default
"createdAt"Value in
"createdAt" | "updatedAt" | "price" | "year" | "mileage" | "brandName" | "modelName"sortDirection?string
Default
"desc"Value in
"asc" | "desc"brandName?string
modelName?string
vehicleTypeName?string
vehicleTypeId?string
yearMin?integer | null
yearMax?integer | null
priceMin?number | null
priceMax?number | null
mileageMax?number | null
transmission?string
Value in
"automatic" | "manual" | "sequential"fuel?string
Value in
"gasoline" | "diesel" | "electric" | "hybrid"condition?string
Value in
"new" | "used"financingAvailable?boolean | null
specialOrder?boolean | null
exteriorColor?string | null
Exterior color name (e.g., 'Red', 'Blue', 'Black')
interiorColor?string | null
Interior color name (e.g., 'Black', 'Beige', 'Brown')
fields?string
Comma-separated list of fields to return (e.g., 'id,brandName,modelName,price,images'). If not specified, all fields are returned.
Response Body
curl -X GET "https://api.motorbase.io/api/v1/{organizationSlug}/inventory?page=1&limit=10&sortField=createdAt&sortDirection=desc&brandName=string&modelName=string&vehicleTypeName=string&vehicleTypeId=string&yearMin=0&yearMax=0&priceMin=0&priceMax=0&mileageMax=0&transmission=automatic&fuel=gasoline&condition=new&financingAvailable=true&specialOrder=true&exteriorColor=string&interiorColor=string&fields=id%2CbrandName%2CmodelName%2Cprice%2Cimages"{
"data": [
{
"id": "string",
"brandId": "string",
"brandName": "string",
"modelId": "string",
"modelName": "string",
"vehicleTypeId": "string",
"vehicleTypeName": "string",
"versionId": "string",
"versionName": "string",
"year": -2147483648,
"mileage": -2147483648,
"interiorColorId": "string",
"interiorColorName": "string",
"exteriorColorId": "string",
"exteriorColorName": "string",
"price": "string",
"armorLevel": "string",
"transmission": "string",
"fuel": "string",
"engine": "string",
"condition": "string",
"images": [
"string"
],
"financingAvailable": true,
"specialOrder": true,
"priceOnRequest": true,
"agentId": "string",
"organizationId": "string",
"createdAt": "2019-08-24",
"updatedAt": "2019-08-24"
}
],
"pagination": {
"total": 0,
"pages": 0,
"currentPage": 0,
"limit": 0,
"hasNextPage": true,
"hasPreviousPage": true
},
"filters": {
"brandName": "string",
"modelName": "string",
"vehicleTypeName": "string",
"vehicleTypeId": "string",
"yearMin": 0,
"yearMax": 0,
"priceMin": 0,
"priceMax": 0,
"mileageMax": 0,
"transmission": "automatic",
"fuel": "gasoline",
"condition": "new",
"financingAvailable": true,
"specialOrder": true,
"exteriorColor": "string",
"interiorColor": "string"
},
"sort": {
"field": "string",
"direction": "asc"
}
}{
"message": "Organization slug is missing"
}{
"message": "Unauthorized"
}