Recursos

Eventos

Todos los endpoints de Eventos, con el ámbito que imponen, el cuerpo que admiten, una respuesta legible y los rechazos que pueden devolver.

Leer el flujo de eventos de la organización.

get/organizations/{organization}/events

Ámbito: events:read
Idempotency-Key: No se acepta
Devuelve: 200

Parámetros de ruta

organizationcadenaObligatorio

La organización en cuyo nombre actúa esta solicitud. La clave debe tener concesión sobre ella.

Parámetros de consulta

limitcadenaOpcional

Cuántos registros devolver. El servidor puede devolver menos.

cursorcadenaOpcional

El next_cursor de la página anterior. El flujo de eventos va del MÁS ANTIGUO al más reciente, así que este cursor avanza hacia los eventos que aún no ha visto. Un cursor codifica los filtros con los que se emitió; enviarlo con otros filtros se rechaza con cursor_invalid.

typecadena, repetibleOpcional

Repítalo para filtrar por más de un tipo de evento. Omítalo para incluir todos los tipos.

Errores

Todos los rechazos que este endpoint puede devolver, con el estado con el que llegan.

Solicitud

curl "https://passportcraft.com/api/v1/organizations/8f14e45f-ceea-467a-9a5f-8dc7d9c6a1b2/events?type=passport.published&limit=25" \
  -H "Authorization: Bearer $PASSPORTCRAFT_API_KEY"

Respuesta · 200

{
  "object": "list",
  "data": [
    {
      "object": "event",
      "id": "e3b0c442-98fc-4c14-9afb-f4c8996fb924",
      "name": "organizations/8f14e45f-ceea-467a-9a5f-8dc7d9c6a1b2/events/e3b0c442-98fc-4c14-9afb-f4c8996fb924",
      "organization_id": "8f14e45f-ceea-467a-9a5f-8dc7d9c6a1b2",
      "type": "passport.published",
      "livemode": true,
      "created_at": "2026-08-01T14:03:22.501Z",
      "related": {
        "object": "passport",
        "id": "2c1f9e07-3b4d-4a18-9f6c-5e0a7b8d3c41",
        "name": "organizations/8f14e45f-ceea-467a-9a5f-8dc7d9c6a1b2/passports/2c1f9e07-3b4d-4a18-9f6c-5e0a7b8d3c41",
        "category": "textile",
        "status": "published",
        "previous_status": "draft",
        "version": 4
      }
    }
  ],
  "has_more": false,
  "next_cursor": "eyJjIjoiMjAyNi0wOC0wMVQxNDowMzoyMi41MDFaIn0"
}

GET /organizations/8f14e45f-ceea-467a-9a5f-8dc7d9c6a1b2/events?type=passport.published&limit=25