Get Consent
Retrieves detailed information about an existing AIS consent, including:
- Current status (created, completed, failed, etc.)
- Associated accounts (if consent is completed)
- Service provider information
- Expiration details
This endpoint returns successfully for any existing consent, regardless of its current status (e.g. created, active, revoked, expired, failed).
Body Parameters
API client identifier
API client secret for authentication. Required for internal (non-OAuth2) authentication mode (e.g., test-only). Not required when using OAuth2 (Bearer token) authentication.
Consent ID to retrieve
Response
Response Attributes
Consent lifecycle status:
created: Consent created via API, not yet initiatedstarted: Consent flow initiated or reset for retrysca_url_retrieved: SCA URL retrieved from banking providerawaiting_authz: User opened SCA URL (link/wrapped_sca only)authorized: User authentication successful, before data fetchactive: Consent active, data persisted to...
createdstartedsca_url_retrievedawaiting_authzauthorizedactiveexpiredrevokedfailedsuspendedTimestamp when the consent authorization link expires (based on expires_in option). After this time, users cannot access the WebUI to complete authorization. This does NOT affect already-active consents.
Number of days the consent remains valid for data access after authorization. When this period ends, the consent is automatically revoked.
Timestamp when the data access consent expires and will be automatically revoked (set after user authorizes, calculated from consent_validity_days). After this time, data access is no longer possible.
Name of the API client application
Internal UUID identifier for the consent
Public identifier for the consent (used in web URLs)
URL where the end-user can complete the consent authorization flow. Null for direct_sca type.
Unique identifier for the API request
Types of data this consent covers
accountsbalancestransactions Show child attributes
Selected AIS method details (available after method selection)
Show child attributes
Service provider (bank) details
Show child attributes
List of account IDs associated with this consent (available after consent is active)
Show child attributes
Information about the most recent successfully completed data refresh job
Show child attributes
Response Attributes
Unique identifier for this error instance
Request identifier for tracking and correlation
Machine-readable error code for 400 errors:
bad_request: Generic validation or request errorvalidation_error: Request payload validation failedinvalid_input: Invalid input data providedunprocessable_entity: Valid request but cannot be processedcooldown_failed: Data refresh cooldown period not yet elapsedconsent_not_active: Consent is not usable...
bad_requestvalidation_errorinvalid_inputunprocessable_entitycooldown_failedconsent_not_activemethod_selection_errormethod_input_validation_errorlink_expiredHuman-readable error message
Response Attributes
Unique identifier for this error instance
Request identifier for tracking and correlation
Machine-readable error code for 401 errors:
unauthorized: Authentication failed or insufficient permissions
unauthorizedHuman-readable error message
Response Attributes
Unique identifier for this error instance
Request identifier for tracking and correlation
Machine-readable error code for 404 errors:
not_found: Generic resource not foundconsent_not_found: Specified consent does not existjob_not_found: Specified job does not exist or outside accessible date range
not_foundconsent_not_foundjob_not_foundHuman-readable error message