Revoke consent

DELETEhttps://api.insurely.com/consents/{consentId}

Revoke a previously authorized PSD2_AIS consent

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 revocation processed 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} \
  -H "Authorization: Bearer <jwt-token>" \
  -X DELETE

RESPONSE 200

{
  "company": "se-nordea",
  "consentId": "550e8400-e29b-41d4-a716-446655440000",
  "createdAt": "2026-01-15T10:30:00Z",
  "pollingInterval": null,
  "scope": {
    "accountIds": [
      "SE1234567890"
    ],
    "balances": true,
    "transactions": true,
    "type": "PSD2_AIS"
  },
  "status": "REVOKED",
  "statusChangedAt": "2026-02-27T14:00:00Z"
}