Referencia

Referencia: Drivers (conductores)

Los conductores de la flota de tu organización. Solo lectura.

GET/v1/drivers

drivers:read

Lista paginada, de más reciente a más antiguo.

Parámetro	Dónde	Tipo	Descripción
`active`	query	`true \| false`	Solo activos o solo inactivos.
`limit`	query	`integer`	1–100, por defecto 25.
`cursor`	query	`string`	El next_cursor anterior.

Petición

curl

curl "https://wearetransfers.com/api/v1/drivers?active=true" \
  -H "Authorization: Bearer $WAT_API_KEY"

Respuesta

json

{
  "data": [
    {
      "id": "1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
      "external_id": null,
      "name": "Marta Gil",
      "nickname": "Marta",
      "phone": "+34600000001",
      "active": true,
      "status": "disponible",
      "has_app_access": true,
      "created_at": "2026-01-15T10:00:00.000Z"
    }
  ],
  "next_cursor": null,
  "has_more": false
}

GET/v1/drivers/{id}

drivers:read

Un conductor por UUID. Ajeno: 404.

Parámetro	Dónde	Tipo	Descripción
`id *`	path	`uuid`	Id del conductor.

Petición

curl

curl https://wearetransfers.com/api/v1/drivers/1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d \
  -H "Authorization: Bearer $WAT_API_KEY"

Respuesta

json

{
  "id": "1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
  "external_id": null,
  "name": "Marta Gil",
  "nickname": "Marta",
  "phone": "+34600000001",
  "active": true,
  "status": "disponible",
  "has_app_access": true,
  "created_at": "2026-01-15T10:00:00.000Z"
}

El objeto Driver

Campo	Tipo	Qué es
`id`	uuid	Es el assignment.driver.id de las reservas.
`external_id`	string \| null	Tu id para este conductor, si lo guardaste.
`name · nickname`	string \| null	Nombre y apodo (el que ve el pasajero).
`phone`	string \| null	Teléfono.
`active`	boolean	Si se le pueden asignar servicios.
`status`	string \| null	Estado operativo tal como lo mantiene la empresa en su panel.
`has_app_access`	boolean	Tiene usuario en la app del conductor.
`created_at`	date-time	Alta.

Solo se exponen los conductores de tu organización: en una reserva ejecutada por otra empresa, assignment.driver es null.