Create Trip - Documentação DEVMOB

curl --request POST \ --url https://api.example.com/api/v1/ops/trips \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "routeId": "0195e7a1-8b5c-7d3e-9f4a-2c6b8d0e1f3c", "vehicleId": "0195e7a1-8b5c-7d3e-9f4a-2c6b8d0e1f3d", "driverId": "0195e7a1-8b5c-7d3e-9f4a-2c6b8d0e1f3e", "departureAt": "2026-04-15T08:00:00.000Z", "estimatedArrivalAt": "2026-04-15T14:00:00.000Z", "stops": [ { "pointId": "0195e7a1-8b5c-7d3e-9f4a-2c6b8d0e1f3c", "stopOrder": 1, "arrivalAt": "2026-04-15T10:00:00.000Z", "departureAt": "2026-04-15T10:15:00.000Z" } ], "itineraries": [ { "fromStopOrder": 1, "toStopOrder": 3, "price": 15000 } ] } '

{ "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" }

Authorizations

Authorization

string

header

required

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

Query Parameters

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.

Body

application/json

Create trip payload

routeId

string<uuid>

required

Route identifier

Example:

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

vehicleId

string<uuid>

required

Vehicle identifier

Example:

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

driverId

string<uuid>

required

Driver identifier

Example:

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

departureAt

string<date-time>

required

Departure time

Example:

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

estimatedArrivalAt

string<date-time>

required

Estimated arrival time

Example:

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

stops

object[]

required

Trip stops (minimum 2)

Minimum array length: 2

Show child attributes

itineraries

object[]

required

Trip itineraries (minimum 1)

Minimum array length: 1

Show child attributes

Response

Created

Viagens programadas combinando rota, veículo e motorista

tripId

string<uuid>

required

Identificador único

companyId

string<uuid>

required

Referência à empresa

routeId

string<uuid>

required

Referência à rota

vehicleId

string<uuid>

required

Referência ao veículo

driverId

string<uuid>

required

Referência ao motorista

departureAt

string<date-time>

required

Data e hora de partida

estimatedArrivalAt

string<date-time>

required

Data e hora estimada de chegada

status

enum<string>

required

Status da viagem

Available options:

SCHEDULED,

IN_PROGRESS,

COMPLETED,

CANCELLED

createdBy

string<uuid> | null

required

Usuário que criou o registro, quando aplicável

createdAt

string<date-time>

required

Data de criação

updatedBy

string<uuid> | null

required

Usuário que fez a última atualização, quando aplicável

updatedAt

string<date-time>

required

Data da última atualização

deletedBy

string<uuid> | null

required

Usuário que removeu o registro, quando aplicável

deletedAt

string<date-time> | null

required

Data de remoção