/api/v1/access-grants/{id}Leggere un'autorizzazione di accesso
Un'autorizzazione della vostra azienda, attiva, scaduta o revocata. Il campo state indica quale. La risposta non contiene mai il token né una parte di esso.
Un id che appartiene a un'altra azienda risponde 404, esattamente come un id inesistente, e non rivela nulla.
Chi può chiamarlo. Una chiave API solo se il suo titolare ha attivato «May manage access grants» per quella chiave nella pagina Developer (disattivato per impostazione predefinita; altrimenti 403 access_grants_not_enabled). Un token OAuth richiede lo scope access_grants:read e il ruolo di editor o superiore.
Parametri di percorso
- idobbligatorio
string (24 hex chars)
ID dell'autorizzazione di accesso.
Header
- Authorizationobbligatorio
string
Bearer <token>— una chiave APItp_(Developer → API Keys; più semplice, per server-to-server) oppure un access token OAuth 2.0 (Developer → OAuth Apps; per app autorizzate dall'utente, scoped e revocabili). La pagina Authentication contiene il flusso OAuth completo e l'elenco degli scopes.e.g. Bearer tp_REDACTED_xxxxxxxxxxxx
Richiesta
curl -sS https://app.tracepass.eu/api/v1/access-grants/6650c1d2e3f4a5b6c7d8e9f0 \
-H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx"Risposta
{
"data": {
"id": "6650c1d2e3f4a5b6c7d8e9f0",
"accessLevel": "restricted",
"label": "Buyer GmbH, order 4711",
"role": "purchaser",
"scope": { "kind": "passports", "ids": ["6650a1b2c3d4e5f6a7b8c9d0"] },
"purpose": null,
"evidence": null,
"state": "active",
"expiresAt": null,
"useCount": 0,
"createdAt": "2026-06-01T09:30:00.000Z"
}
}