List consents

Returns the consents a customer has granted you. Filter by status, customer, or scope, and use `updated_after` for incremental sync. Results are cursor-paginated.

Returns the consents a customer has granted you. Filter by status, customer, or scope, and use updated_after for incremental sync. Results are cursor-paginated.

Authorization

bearerAuth

AuthorizationBearer <token>

A sender-constrained access token from the token endpoint, presented over mutual TLS with the bound client certificate.

In: header

Query Parameters

statusstring

Only return consents in this state.

Value in"created" | "active" | "expired" | "revoked"

customer_idstring

Only return consents for this customer.

scopestring

Only return consents that include this scope.

updated_afterstring

Only return consents changed at or after this RFC 3339 timestamp. Use your last sync time for incremental polling.

Formatdate-time

cursorstring

Opaque pagination cursor from a previous response's next_cursor.

page_sizeinteger

Maximum consents to return per page.

Default50

Rangevalue <= 200

Response Body

`application/json`

curl -X GET "https://example.com/consents"

{  "data": [    {      "consent_id": "cnst_8H2kQ9",      "arrangement_id": "arr_5f9c2a1b",      "status": "active",      "app_name": "Your Company",      "customer_id": "cust_31ab",      "scopes": [        "openid",        "bank:accounts.basic:read",        "bank:transactions:read"      ],      "account_ids": [        "acc_001",        "acc_002"      ],      "granted_at": "2026-05-01T09:30:00Z",      "expires_at": "2026-07-30T09:30:00Z",      "updated_at": "2026-05-01T09:30:00Z",      "revoked_at": null    }  ],  "next_cursor": null}