Ressources

Événements

Chaque point de terminaison Événements, avec la portée qu'il impose, le corps qu'il accepte, une réponse lisible et les refus qu'il peut renvoyer.

Lire le flux d’événements de l’organisation.

get/organizations/{organization}/events

Portée: events:read
Idempotency-Key: Non accepté
Renvoie: 200

Paramètres de chemin

organizationstringObligatoire

L'organisation pour laquelle cette requête agit. La clé doit disposer d'une autorisation sur celle-ci.

Paramètres de requête

limitstringFacultatif

Le nombre d'enregistrements à renvoyer. Le serveur peut en renvoyer moins.

cursorstringFacultatif

Le next_cursor de la page précédente. Un curseur encode les filtres sous lesquels il a été émis ; l'envoyer avec d'autres filtres est refusé par cursor_invalid.

typestring, repeatableFacultatif

Répétez le paramètre pour filtrer sur plusieurs types d'événements. Omettez-le pour les avoir tous.

Erreurs

Tous les refus que ce point de terminaison peut renvoyer, avec le statut qui les accompagne.

Requête

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

Réponse · 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