Skip to main content
GET
List Trips

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

limit
number
default:10

Items per page

Example:

10

page
number
default:1

Page number

Example:

1

filter
string

Generic filter that matches against

  • origin
  • destination
Example:

"São Paulo"

originName
string

Origin name (geo-radius search)

Example:

"São Paulo"

destinationName
string

Destination name (geo-radius search)

Example:

"Rio de Janeiro"

departureFrom
string<date-time>

Departure from

Example:

"2026-04-15T00:00:00.000Z"

departureTo
string<date-time>

Departure to

Example:

"2026-04-16T00:00:00.000Z"

driverId
string<uuid>

Driver identifier

Example:

"0195e7a1-8b5c-7d3e-9f4a-2c6b8d0e1f3e"

routeId
string<uuid>

Route identifier

Example:

"0195e7a1-8b5c-7d3e-9f4a-2c6b8d0e1f3e"

status
enum<string>

Trip status

Available options:
SCHEDULED,
IN_PROGRESS,
COMPLETED,
CANCELLED
Example:

"SCHEDULED"

vehicleId
string<uuid>

Vehicle identifier

Example:

"0195e7a1-8b5c-7d3e-9f4a-2c6b8d0e1f3d"

sortBy
enum<string>
default:departureAt

Field to sort by

Available options:
departureAt,
estimatedArrivalAt,
createdAt
Example:

"departureAt"

sortOrder
enum<string>
default:desc

Sort order

Available options:
asc,
desc
Example:

"desc"

fields
string

Comma-separated list of fields to include in the response. Supports dot notation for nested projection (e.g. id,name,user.email,trips.route.id). Unknown fields are silently dropped.

Response

OK

List trips

data
object[]
required
meta
object
required