---
title: "List"
method: GET
path: "/shipping/drivers/list/v1"
tags: ["/shipping/drivers"]
---

# List

`GET /shipping/drivers/list/v1`

Lists all drivers belonging to the caller's organization with filtering, sorting, pagination, and optional full-text search. | () -> (DriverListRes)

## Query parameters

- `sort_order` 'asc' | 'desc' — Sort order for query results
- `page` integer
- `page_size` integer
- `search` string, nullable — Full-text search query
- `filter_waiting` boolean, nullable — Filter by waiting status
- `filter_auto_assign_enabled` boolean, nullable — Filter by automatic assignment consent
- `filter_vehicle_type` VehicleTypeEnum[], nullable — Filter by any matching vehicle type
- `filter_by_driver_id` string, nullable — Filter by driver ID
- `filter_archived` boolean — Select archived drivers instead of active drivers
- `filter_available_according_to_driver` boolean, nullable — Filter by driver's self-reported availability
- `filter_available_according_to_operators` boolean, nullable — Filter by operator-set availability
- `filter_status` DriverStatusEnum[], nullable — Filter by driver state (UNASSIGNED / ASSIGNED / IN_PROGRESS)

## Response `200`

Successful Response

- DriverListRes
  - `items` DriverWithActiveTaskGroupIds1[], required — unresolved $ref
  - `total_count` integer, required

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-16** `90f02389cb0d` — 3 info
  - added the new optional `query` request parameter `filter_auto_assign_enabled`
  - added the new optional `query` request parameter `filter_vehicle_type`
  - added the new optional `query` request parameter `filter_waiting`
- **2026-09-11** `7cf361125675` — 3 info
  - added the new optional `query` request parameter `filter_archived`
  - added the new optional `query` request parameter `filter_by_driver_id`
  - added the optional property `items/items/archived_at_timestamp` to the response with the `200` status

[Change history](https://skmtc.dev/chrt/apis/chrt-fastapi/changes/shipping/drivers/list/v1/get.md)

---

[API](https://skmtc.dev/chrt/apis/chrt-fastapi.md) · [All operations](https://skmtc.dev/chrt/apis/chrt-fastapi/llms.txt) · [OpenAPI document](https://skmtc.dev/chrt/apis/chrt-fastapi/revisions/90f02389cb0d?raw)