Skip to main content
GET
/
api
/
v1
/
ops
/
reports
/
trips
/
insights
Get Trips Insights
curl --request GET \
  --url https://api.example.com/api/v1/ops/reports/trips/insights \
  --header 'Authorization: Bearer <token>'
{
  "scheduled": 12,
  "inProgress": 3,
  "disrupted": 1,
  "occupancyRate": 72.5
}

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
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"

​
destinationName
string

Destination name

Example:

"Rio de Janeiro"

​
driverId
string<uuid>

Driver identifier

​
filter
string

Generic filter that matches against

  • origin
  • destination
Example:

"São Paulo"

​
originName
string

Origin name

Example:

"São Paulo"

​
routeId
string<uuid>

Route identifier

​
vehicleId
string<uuid>

Vehicle identifier

​
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

Trips insights

​
scheduled
integer
required

Scheduled count

Example:

12

​
inProgress
integer
required

In progress count

Example:

3

​
disrupted
integer
required

Cancelled or delayed count

Example:

1

​
occupancyRate
number
required

Occupancy percent

Required range: x >= 0
Example:

72.5