DealerAI Docs
API Reference

Search Cars

Searches both new and used car inventory using natural language queries. Translates the query into structured filters and returns matching vehicles from the dealership's inventory.

POST
/api/v1/search

Authorization

basic
AuthorizationBasic <token>

Basic Authorization header

In: header

Request Body

application/json

The search request containing the natural language query and pagination parameters.

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://api-dev.dealerai.dev/api/v1/search" \  -H "Content-Type: application/json" \  -d '{}'
{
  "total_row_count": 0,
  "row_count": 0,
  "rows": [
    {
      "vin": "string",
      "stock_number": "string",
      "display_name": "string",
      "manufacturer": "string",
      "model": "string",
      "trim": "string",
      "year": 0,
      "type": "string",
      "condition": "string"
    }
  ]
}
{
  "message": "string",
  "details": null
}
{
  "message": "string",
  "details": null
}
{
  "message": "string",
  "details": null
}

Translate Search Query

Converts a natural language car search query into a structured logic expression using OpenAI. Returns filter criteria that can be used for precise inventory searches.

Get Used Cars

Retrieves a paginated list of used cars for the authenticated dealership, ordered by creation date.