Listar bitácora de auditoría del equipo

GET

/logs/team

const url = 'https://api.dev.lade.com.mx/logs/team?teamId=2489E9AD-2EE2-8E00-8EC9-32D5F69181C0&page=1&limit=20&action=CREATE&entity=CLIENT';
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/logs/team?teamId=2489E9AD-2EE2-8E00-8EC9-32D5F69181C0&page=1&limit=20&action=CREATE&entity=CLIENT' \
  --header 'Authorization: Bearer <token>'

Lista las entradas de auditoría del equipo (creación, actualización, baja/alta de clientes, conductores, vehículos, viajes, rutas y puntos de ruta), con paginación y filtros por acción, tipo de entidad y rango de fechas.

Authorizations

cognitoAuth

Parameters

Query Parameters

teamId

required

string format: uuid

page

integer

default: 1

limit

integer

default: 20 <= 100

Tope 100

action

string

Allowed values: CREATE UPDATE DELETE ACTIVATE DEACTIVATE

entity

string

Allowed values: CLIENT DRIVER VEHICLE TRIP ROUTE ROUTE_POINT

from

string format: date

Responses

200

Bitácora paginada

application/json

object

logs

Array<object>

object

string

action

string

Allowed values: CREATE UPDATE DELETE ACTIVATE DEACTIVATE

entity

string

Allowed values: CLIENT DRIVER VEHICLE TRIP ROUTE ROUTE_POINT

entityId

string

teamId

string format: uuid

description

string

changes

Diff antes/después de los campos modificados

object

occurredAt

string format: date-time

actor

object

string

name

string

email

string

total

integer

page

integer

limit

integer

totalPages

integer

Example

{
  "logs": [
    {
      "id": "hh0e8400-e29b-41d4-a716-446655440012",
      "action": "UPDATE",
      "entity": "DRIVER",
      "entityId": "770e8400-e29b-41d4-a716-446655440002",
      "teamId": "550e8400-e29b-41d4-a716-446655440000",
      "description": "Conductor Juan Pérez actualizado",
      "changes": {
        "phone": {
          "before": "5551234567",
          "after": "5559876543"
        }
      },
      "occurredAt": "2026-07-25T10:00:00Z",
      "actor": {
        "id": "660e8400-e29b-41d4-a716-446655440001",
        "name": "Admin García",
        "email": "admin@ejemplo.com"
      }
    }
  ],
  "total": 1,
  "page": 1,
  "limit": 20,
  "totalPages": 1
}

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