GET
/fdx/consents/{consentId}/revocationGet consent grant revocations
Retrieves the revocation history for a specific FDX consent grant. Supply consentId to identify the grant whose revocation records you want to inspect. Records are returned with the most recent revocation first and an empty array indicates that the grant has never been revoked.
- RetriesRetries up to 2×, 500ms backoff, 30s timeout.
consentIdstringrequired
The unique identifier of the consent grant whose revocation history to retrieve.
200Returns a `revocations` array ordered from most recent to oldest; the array is empty when the grant has never been revoked.
revocationsarray<object>required
Revocation records for the consent grant, most recent first. Empty when the grant has never been revoked.
defaultReturned when the request cannot be processed. The FDX error response contains `error_type`, `error_code`, and `error_message`.
error_typestringrequired
Broad categorization of the error. Stable, and safe for programmatic use. Common values are `BAD_REQUEST`, `NOT_FOUND`, `CONFLICT`, and `INTERNAL_SERVER_ERROR`.
error_codestringrequired
The particular error code. Stable, and safe for programmatic use. For example `32` for a malformed request, `1107` when the consent grant is not found, `409` when the grant is already in a terminal state, and `01` for an internal error.
error_messagestringrequired
A developer-friendly description of the error code. Subject to change, so it is not safe for programmatic use.
Error handling
consentId must identify the consent grant whose revocation history you want to retrieve. Read the required revocations response field to process the records, which include status, reason, initiator, and update time.