Routes

Get consent status

GEThttps://api.insurely.com/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

consentIdstring

The unique identifier of the consent

Header Parameters

Insurely-Versionstring

Specifies the API version to use. Must match the version of the endpoint you are targeting.

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

autoStartTokenstring

Auto-start token for Swedish BankID authentication

companystring

The 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 consent scope details

One of these types:

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

PSD2 AIS consent scope with account access details

accountIdsArray<string>
balancesboolean
transactionsboolean
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

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