List Authorisations
Return every ยง9 step 3 authorisation grant against the record's
versions, newest first. One row per
version.authorization_granted audit event. The list isn't
paginated โ authorisations are bounded (at most one per
(version, text_version) pair).
โถPath params
| Param | Description |
|---|---|
recordId | DDS record id |
โถWhy 404 instead of empty list
The handler runs a parent-record visibility check first. If the
record isn't visible to the caller (cross-org or missing), the
response is 404 rather than 200 + [], so clients can
distinguish "no authorisations" from "no permission".
โถResponse shape
Each row uses the same attributes shape as the POST endpoint โ
see Create Authorisation. Ordering is
by granted_at DESC so the most recent acknowledgement (for
the current version) appears first.
Use cases:
- Inspector view: "show me every authorisation on this record".
- UI: highlight the current-version authorisation by filtering
to the row whose
version_idmatches the record'scurrent_version.id.
โถErrors
| Status | Code | When |
|---|---|---|
| 401 | UNAUTHORIZED | Missing/invalid API key |
| 404 | NOT_FOUND | Record isn't visible to the caller |
Required scope:
ingestions:read