Listar alertas del equipo

GET

/teams/{teamId}/alerts

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

Lista las alertas operativas del equipo, más recientes primero.

Authorizations

cognitoAuth

Parameters

Path Parameters

teamId

required

string format: uuid

ID del equipo (UUID)

Query Parameters

unreadOnly

string

default: false

Allowed values: true false

Si es ‘true’, solo devuelve alertas no leídas

limit

integer

default: 50 <= 100

Tope 100

Responses

200

Lista de alertas

application/json

object

alerts

Array<object>

Alerta operativa generada por el sistema (vencimientos, fallos de facturación, límites de plan, etc.)

object

string format: uuid

teamId

string format: uuid

type

Tipo de alerta, generado por el dominio que la origina

string

severity

string

Allowed values: info warning error

title

string

message

string

entityType

string

nullable

entityId

string

nullable

read

boolean

createdAt

string format: date-time

count

integer

Example

{
  "alerts": [
    {
      "id": "ff0e8400-e29b-41d4-a716-446655440010",
      "teamId": "550e8400-e29b-41d4-a716-446655440000",
      "type": "INVOICE_DRAFT_FAILED",
      "severity": "error",
      "title": "Fallo al generar factura",
      "message": "No se pudo generar el borrador de factura del viaje 880e8400...",
      "read": false,
      "createdAt": "2026-07-25T14:00:00Z"
    }
  ],
  "count": 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"
}