CarStat.dev
Connect key
GET/carsExport

Export vehicles with a cursor

Stream every active car in your sources, with full reports, through a server-side cursor. Built for keeping a local copy in sync.

  • Start without scroll_id, then request each next_url unchanged until scroll_id is null. See the sync guide.
  • limit is 1–2,000 (default 500). scroll_time is 1–15 minutes (default 10).
  • Keep domains[] and is_leasing the same for the whole pass. Changing them returns 422.
  • total can be null if its cache entry was lost.

Query parameters

6
limitinteger1–2,000 · default 500

Items per batch. Default 500; maximum 2000. Positive values are required for a usable export.

scroll_timeinteger1–15 · default 10

Cursor lifetime in minutes. Default 10, maximum 15.

scroll_idstring

Opaque cursor from the preceding response. Prefer following next_url.

domains[]integer[]≥ 1

Optional source scope. Use IDs returned by GET /domains. Omit to use all enabled domains. Repeat the bracketed parameter: domains[]=33&domains[]=34. Every ID must be enabled for this key.

is_leasingboolean

Optional leasing filter. Send true (or 1) for listings explicitly marked is_leasing=true. Send false (or 0) to exclude true, including stored false, null and missing fields. Omit for no leasing filter; empty or invalid values return 422. A car must have at least one matching active listing in the enabled/selected domain scope. Other listings can remain in the response, so cars with mixed listing types can match both values. For /cars, set this on the first request and follow next_url unchanged; false is preserved. Continuing with only scroll_id retains the filter. Changing or adding the filter mid-scroll returns 422. If cached filter state is lost or the scroll predates this parameter, an explicit value returns 422; start a new scroll.

langstring

Response locale. Option translations are also limited by the account languages. The page selects its current language automatically.

Returns · A batch of full Car objects in data, with next_url, scroll_id and total. The last page has scroll_id: null, empty data and message: "No more data".
GET/cars
curl -g "https://api.lotarius.com/cars?limit=5&api_key=$CARS_API_KEY" \
  -H "Accept: application/json"
ExamplesRecorded
{4 keys
"data": [1 item
0: {20 keys
"id": "290nw54Bkl-iPxZqEe_N"
"has_inspections": false
"has_history_reports": false
"year": 2007
"vin": "kmhdu46d27u158653"
"brand": {2 keys}
"model": {2 keys}
"engine_volume": 2000
"cylinders": 4
"body_type": {2 keys}
"fuel": {2 keys}
"color": {2 keys}
"power_hp": 138
"market_origin": {2 keys}
"drive_wheels": {2 keys}
"option_ids": []
"listings": [1 item]
"inspections": []
"vehicle_history_reports": []
"hash": "473326c69c007f50506c0cffdf30b08cf28e978d9ff2d5e7dca0dc75a54a3f6c"
}
]
"next_url": "https://api.lotarius.com/cars?scroll_id=FGluY2x1ZGVfY29udGV4dF91…&lang=en&api_key=YOUR_API_KEY&limit=2"
"scroll_id": "FGluY2x1ZGVfY29udGV4dF91…"
"total": 3217391
}