This is a preview version of the API intended for early testing and integration. Preview versions are not stable and may include breaking changes before general availability.

ConsentStatusResponse

Response containing current consent status and authentication instructions

authInstructions

Authentication instructions. Present during AWAITING_AUTHORIZATION status.

One of these types:

Properties below are from the SwedishBankIdAutostartToken subtype. View the full schema for full details.

Swedish BankID autostart token authentication instructions

autoStartTokenstring

Auto-start token for Swedish BankID authentication

companystring

Company identifier.

consentIdstring

The unique identifier of the consent

createdAtstring[date-time]

Timestamp when the consent was created

errorConsentStatusError

Error details. Present when status is FAILED.

expiresAtstring[date-time]

Expiration timestamp of the consent. Present only when status is AUTHORIZED.

pollingIntervalinteger[int32]

Recommended polling interval in milliseconds. Present for non-terminal statuses.

revokedAtstring[date-time]

Timestamp when the consent was revoked. Present only when status is REVOKED.

scope

The permissions granted under this consent, including which accounts and data types (balances, transactions) are accessible.

One of these types:

Properties below are from the Psd2AisConsentScope subtype. View the full schema for full details.

PSD2 AIS consent scope with account access details

accountIdsArray<string>

Bank account identifiers this consent grants access to. When absent, the consent covers all accounts available at the bank.

balancesboolean

Whether this consent grants permission to read account balances.

transactionsboolean

Whether this consent grants permission to fetch account transactions.

typestring

Scope type discriminator.

Possible Enum values are PSD2_AIS.

statusstring

The current status of the consent

Possible Enum values are INITIATED, AWAITING_AUTHORIZATION, AUTHORIZED, REVOKED, EXPIRED or FAILED.

statusChangedAtstring[date-time]

Timestamp when the status was last changed

Example

{
  "authInstructions": "-- Missing example --",
  "company": "se-nordea",
  "consentId": "550e8400-e29b-41d4-a716-446655440000",
  "createdAt": "2026-01-15T10:30:00Z",
  "error": {
    "code": "AUTHENTICATION_TIMEOUT",
    "message": "User did not complete BankID authentication within the time limit"
  },
  "expiresAt": "2026-12-31T23:59:59Z",
  "pollingInterval": 1000,
  "revokedAt": "2026-01-20T15:00:00Z",
  "scope": "-- Missing example --",
  "status": "INITIATED",
  "statusChangedAt": "2026-01-15T10:31:00Z"
}

{  "authInstructions": "-- Missing example --",  "company": "se-nordea",  "consentId": "550e8400-e29b-41d4-a716-446655440000",  "createdAt": "2026-01-15T10:30:00Z",  "error": {    "code": "AUTHENTICATION_TIMEOUT",    "message": "User did not complete BankID authentication within the time limit"  },  "expiresAt": "2026-12-31T23:59:59Z",  "pollingInterval": 1000,  "revokedAt": "2026-01-20T15:00:00Z",  "scope": "-- Missing example --",  "status": "INITIATED",  "statusChangedAt": "2026-01-15T10:31:00Z"}