Routes

SE · Wealth API · 2026-04-01

Get consent status

GEThttps://api.anessa.co/consents/{consentId}/status

Returns the current status of a consent with authentication instructions for BankID flows. Clients should poll this endpoint to track consent authorization progress.

Request

Path Parameters

consentIdstringrequired

The unique identifier of the consent

Header Parameters

Api-Versionstringrequired

The API version to use, as YYYY-MM-DD. Must match the version of the endpoint you are targeting. A request without it, or with a version older than the client's minimum API version, is served by the client's minimum API version. The legacy Insurely-Version header is still accepted for versions before 2027-01-01; send only one of the two.

Possible Enum values are 2026-04-01.

Responses

Consent status retrieved successfully.

Body

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

autoStartTokenstringrequired

Auto-start token for Swedish BankID authentication

companystringrequired

Company identifier.

consentIdstringrequired

The unique identifier of the consent

createdAtstringrequired[date-time]

Timestamp when the consent was created

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.

balancesbooleanrequired

Whether this consent grants permission to read account balances.

transactionsbooleanrequired

Whether this consent grants permission to fetch account transactions.

typestringrequired

Scope type discriminator.

Possible Enum values are PSD2_AIS.
statusstringrequired

The current status of the consent

Possible Enum values are INITIATED, AWAITING_AUTHORIZATION, AUTHORIZED, REVOKED, EXPIRED or FAILED.
statusChangedAtstringrequired[date-time]

Timestamp when the status was last changed

cURL
curl https://api.anessa.co/consents/{consentId}/status \
  -H "Authorization: Bearer <jwt-token>" \
  -H "Api-Version: 2026-04-01"
RESPONSE 200
{
  "company": "se-nordea-psd2",
  "consentId": "550e8400-e29b-41d4-a716-446655440000",
  "createdAt": "2026-01-15T10:30:00Z",
  "expiresAt": "2026-12-31T23:59:59Z",
  "pollingInterval": null,
  "scope": {
    "accountIds": [
      "SE1234567890"
    ],
    "balances": true,
    "transactions": true,
    "type": "PSD2_AIS"
  },
  "status": "AUTHORIZED",
  "statusChangedAt": "2026-01-15T10:31:00Z"
}