Get drivers
Lists the drivers belonging to the authenticated company, oldest first (ordered by creation time ascending). Soft-deleted drivers are excluded, and results never cross company boundaries.
Drivers only exist for companies whose compliance type is METRC or BIOTRACK; a company with any other compliance type simply returns an empty list here.
Results are paginated. The response next_page holds the URL of the following page, or null on
the last page.
Required permission: settings_permissions_drivers.
BearerAuthorizationBearer <token>API token generated in Distru (Settings → Distru API). Send it on every request as Authorization: Bearer YOUR_API_TOKEN.
ids[]?array<string>Restrict the result to specific drivers by ID (the same ID returned as each driver'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?stringFilter to drivers 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?stringFilter to drivers 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?stringPage 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.
A list of drivers
*/*- response
A collection of drivers
data?array<>Drivers
next_page?stringURL for the next page of results; null when there is no next page
curl -X GET 'https://app.distru.com/public/v1/drivers'{ "data": [ { "birth_date": "1990-01-01", "driver_license": "D1234567", "email": "[email protected]", "first_name": "Test", "hire_date": "2020-01-01", "id": "00000000-0000-0000-0000-000000000001", "inserted_datetime": "2025-01-01T00:00:00.000000Z", "last_name": "Driver", "occupational_license_number": null, "phone_number": null, "updated_datetime": "2026-10-08T09:10:04.250880Z", "us_state": "CA" }, { "birth_date": "1990-01-01", "driver_license": "D1234567", "email": "[email protected]", "first_name": "Test", "hire_date": "2020-01-01", "id": "00000000-0000-0000-0000-000000000002", "inserted_datetime": "2025-01-02T00:00:00.000000Z", "last_name": "Driver", "occupational_license_number": null, "phone_number": null, "updated_datetime": "2026-10-08T09:10:04.260364Z", "us_state": "CA" }, { "birth_date": "1990-01-01", "driver_license": "D1234567", "email": "[email protected]", "first_name": "Test", "hire_date": "2020-01-01", "id": "00000000-0000-0000-0000-000000000003", "inserted_datetime": "2025-01-03T00:00:00.000000Z", "last_name": "Driver", "occupational_license_number": null, "phone_number": null, "updated_datetime": "2026-10-08T09:10:04.268355Z", "us_state": "CA" } ], "next_page": "https://www.example.com/public/v1/drivers?page[after]=ZHwyMDI1LTAxLTAzVDAwOjAwOjAwLjAwMDAwMFp8aXwwMDAwMDAwMC0wMDAwLTAwMDAtMDAwMC0wMDAwMDAwMDAwMDM"}