Viajes asignados al conductor autenticado

GET

/drivers/me/trips

const url = 'https://api.dev.lade.com.mx/drivers/me/trips?status=NO_INICIADO&limit=50';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url 'https://api.dev.lade.com.mx/drivers/me/trips?status=NO_INICIADO&limit=50' \
  --header 'Authorization: Bearer <token>'

Lista los viajes asignados al conductor dueño del token, usando el índice disperso GSI1 (GSI1PK=DRIVER#{driverId}) escrito por trips/assign. Soporta paginación y un filtro opcional status aplicado en memoria sobre la página obtenida.

Authorizations

cognitoDriversAuth

Parameters

Query Parameters

status

Estado del viaje

string

Allowed values: NO_INICIADO EN_PROCESO FINALIZADO_A_TIEMPO FINALIZADO_CON_RETRASO CANCELADO

Filtra por estado de viaje (aplicado sobre la página obtenida)

limit

integer

default: 50 <= 100

Máximo de resultados por página (tope 100)

nextToken

string

Token de paginación devuelto por la página anterior

Responses

200

Lista de viajes asignados

application/json

object

trips

Array<object>

object

string format: uuid

teamId

string format: uuid

status

Estado del viaje

string

Allowed values: NO_INICIADO EN_PROCESO FINALIZADO_A_TIEMPO FINALIZADO_CON_RETRASO CANCELADO

routeId

string format: uuid

nullable

routeName

string

nullable

clientId

string format: uuid

nullable

clientName

string

nullable

driverId

string format: uuid

nullable

driverName

string

nullable

driverPhone

string

nullable

vehicleId

string format: uuid

nullable

vehiclePlate

string

nullable

startDate

string format: date-time

nullable

endDate

string format: date-time

nullable

actualEndDate

string format: date-time

nullable

cargoDescription

string

nullable

cargoWeight

Weight in kg

number

nullable

cargoVolume

Volume in m3

number

nullable

cost

number

nullable

revenue

number

nullable

notes

string

nullable

specialInstructions

string

nullable

cancelledAt

string format: date-time

nullable

cancelledBy

string

nullable

createdAt

string format: date-time

nextToken

string

nullable

Example

{
  "trips": [
    {
      "id": "880e8400-e29b-41d4-a716-446655440003",
      "teamId": "550e8400-e29b-41d4-a716-446655440000",
      "driverId": "770e8400-e29b-41d4-a716-446655440002",
      "status": "ASIGNADO"
    }
  ],
  "nextToken": null
}

401

No autenticado

application/json

object

error

required

string

message

string

field

string

Example

{
  "error": "Unauthorized",
  "message": "Invalid or expired token"
}

403

Sin permisos

application/json

object

error

required

string

message

string

field

string

Example

{
  "error": "Forbidden",
  "message": "You don't have permission to access this resource"
}