List Trips - Documentação DEVMOB

{ "data": [ { "tripId": "3c90c3cc-0d44-4b50-8888-8dd25736052a", "companyId": "3c90c3cc-0d44-4b50-8888-8dd25736052a", "routeId": "3c90c3cc-0d44-4b50-8888-8dd25736052a", "vehicleId": "3c90c3cc-0d44-4b50-8888-8dd25736052a", "driverId": "3c90c3cc-0d44-4b50-8888-8dd25736052a", "departureAt": "2023-11-07T05:31:56Z", "estimatedArrivalAt": "2023-11-07T05:31:56Z", "createdBy": "3c90c3cc-0d44-4b50-8888-8dd25736052a", "createdAt": "2023-11-07T05:31:56Z", "updatedBy": "3c90c3cc-0d44-4b50-8888-8dd25736052a", "updatedAt": "2023-11-07T05:31:56Z", "deletedBy": "3c90c3cc-0d44-4b50-8888-8dd25736052a", "deletedAt": "2023-11-07T05:31:56Z" } ], "meta": { "page": 1, "limit": 20, "total": 125, "totalPages": 7 } }

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-2c6b8d0e1f3c"

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

data

object[]

required

Show child attributes