Risorse

Eventi

Tutti gli endpoint Eventi, con l'ambito che impongono, il corpo che accettano, una risposta leggibile e i rifiuti che possono restituire.

Leggere il flusso di eventi dell’organizzazione.

get/organizations/{organization}/events

Ambito: events:read
Idempotency-Key: Non accettata
Restituisce: 200

Parametri di percorso

organizationstringObbligatorio

L'organizzazione per cui questa richiesta agisce. La chiave deve avere una concessione su di essa.

Parametri di query

limitstringFacoltativo

Quanti record restituire. Il server può restituirne meno.

cursorstringFacoltativo

Il next_cursor della pagina precedente. Un cursore codifica i filtri con cui è stato emesso; inviarlo con filtri diversi viene rifiutato con cursor_invalid.

typestring, repeatableFacoltativo

Da ripetere per filtrare su più di un tipo di evento. Se omesso, li restituisce tutti.

Errori

Tutti i rifiuti che questo endpoint può restituire, con lo stato con cui arrivano.

Richiesta

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

Risposta · 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