Listar cajas del equipo

GET

/teams/{teamId}/boxes

const url = 'https://api.dev.lade.com.mx/teams/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/boxes?page=1&limit=50&status=DISPONIBLE';
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/teams/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/boxes?page=1&limit=50&status=DISPONIBLE' \
  --header 'Authorization: Bearer <token>'

Lista las cajas del equipo con búsqueda por código/tipo, filtro por estado, y paginación en memoria (trae hasta 500 y pagina en la lambda).

Authorizations

cognitoAuth

Parameters

Path Parameters

teamId

required

string format: uuid

ID del equipo (UUID)

Query Parameters

page

integer

default: 1

limit

integer

default: 50 <= 100

Tope 100

search

string

Búsqueda case-insensitive sobre code y boxType

status

string

Allowed values: DISPONIBLE EN_VIAJE APARTADA RENTADA MANTENIMIENTO DESACTIVADA

Responses

200

Lista paginada de cajas

application/json

object

data

Array<object>

Caja de traslado/almacenaje — contenedor de carga seca intercambiable, activo propio del equipo (no un atributo del vehículo)

object

string format: uuid

teamId

string format: uuid

code

Identificador visible de la caja, se normaliza a mayúsculas

string

boxType

string

Allowed values: SECA REFRIGERADA PLATAFORMA OTRO

capacityM3

number

nullable

capacityKg

number

nullable

dailyRate

Tarifa diaria por defecto para rentas de esta caja

number

status

string

Allowed values: DISPONIBLE EN_VIAJE APARTADA RENTADA MANTENIMIENTO DESACTIVADA

currentVehicleId

string

nullable

currentReservationId

string

nullable

currentClientId

string

nullable

currentClientName

string

nullable

currentLocation

object

notes

string

nullable

createdAt

string format: date-time

updatedAt

string format: date-time

pagination

object

total

integer

page

integer

limit

integer

hasMore

boolean

Example

{
  "data": [
    {
      "id": "bb0e8400-e29b-41d4-a716-446655440006",
      "code": "CAJA-001",
      "status": "DISPONIBLE"
    }
  ],
  "pagination": {
    "total": 1,
    "page": 1,
    "limit": 50,
    "hasMore": false
  }
}

400

Solicitud inválida

application/json

object

error

required

string

message

string

field

string

Example

{
  "error": "Validation failed",
  "field": "email",
  "message": "Invalid email format"
}

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