APIVehicle

Get vehicles

GET
/public/v1/vehicles

List the authenticated company's vehicles, oldest first (by creation time, ascending). Only vehicles owned by the API key's company are returned; soft-deleted vehicles are omitted. Narrow the result with the inserted_datetime and updated_datetime range filters, or omit them to return the full set, paginated.

Results are paged; follow next_page in the response envelope until it is null to walk every page.

Required permission: settings_permissions_vehicles.

Authorization

Bearer
headerAuthorizationBearer <token>

API token generated in Distru (Settings → Distru API). Send it on every request as Authorization: Bearer YOUR_API_TOKEN.

Query Parameters

ids[]?array<string>

Restrict the result to specific vehicles by ID (the same ID returned as each vehicle's id). Repeat the bracketed key once per ID. Unknown IDs simply match nothing; an empty list is treated as no filter. At most 200 IDs may be given.

inserted_datetime?string

Filter to vehicles by their creation datetime, given as a comma-separated start,end pair of ISO8601 datetimes (inclusive). Either bound may be omitted for an open-ended range: 2022-07-10T00:00:00Z, matches on or after that instant, ,2022-07-10T00:00:00Z matches on or before it.

updated_datetime?string

Filter to vehicles by their last-updated datetime, given as a comma-separated start,end pair of ISO8601 datetimes (inclusive). Either bound may be omitted for an open-ended range.

page?string

Page selector. Page size is fixed by the server; paginate by following the next_page URL in each response rather than building page selectors yourself — it is null on the last page. next_page uses page[after]=<cursor>, an opaque token marking where the next page resumes; pass it back exactly as given, and only to the endpoint that issued it. This is seek-based, so every page stays fast no matter how deep you page.

Response Body

A list of vehicles

*/*
  1. response

A collection of vehicles

data?array<>

Vehicles

next_page?string

URL for the next page of results; null when there is no next page

Example Request
curl -X GET 'https://app.distru.com/public/v1/vehicles'
Example Response
{  "data": [    {      "color": "Red",      "description": "Test Vehicle",      "id": "00000000-0000-0000-0000-000000000002",      "inserted_datetime": "2026-08-24T16:01:02.383736Z",      "license_plate_number": "1234567890ABCDEFG",      "license_plate_state": "CA",      "make": "Toyota",      "model": "Camry",      "updated_datetime": "2026-08-24T16:01:02.383736Z",      "vin": "1234567890ABCDEFG",      "year": "2020"    },    {      "color": "Red",      "description": "Test Vehicle",      "id": "00000000-0000-0000-0000-000000000003",      "inserted_datetime": "2026-08-24T16:01:02.390678Z",      "license_plate_number": "1234567890ABCDEFG",      "license_plate_state": "CA",      "make": "Honda",      "model": "Civic",      "updated_datetime": "2026-08-24T16:01:02.390678Z",      "vin": "1234567890ABCDEFG",      "year": "2020"    }  ],  "next_page": null}