List/Search Routes
List Routes
List and search routes with filters and pagination.
GET
List/Search Routes
Use this to find routes — by date, status, driver, or free-text search — when you have no route ID to start from. The payload is deliberately slim: enough to identify a route and show it in a list, not the whole plan. Read Get Route once you know which one you want.
startDate defaults to 30 days ago, so a call with no date range returns the recent past rather than everything you have ever run.Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
Required range:
1 <= x <= 100Example:
25
Required range:
x >= 0Example:
0
ASC or DESC, applied to created_at
Defaults to 30 days ago.
Defaults to now.
Comma-separated order tags; matches routes with an order carrying any of them
Free-form search
Filter by dispatched state
Comma-separated
Comma-separated
Comma-separated
Comma-separated pickup/dropoff cities
Comma-separated pickup/dropoff states
Comma-separated pickup/dropoff countries