API explorerPay APIsData APIs

Theme switcher

List Transactions

Retrieves a list of bank transactions with optional filtering and keyset-based pagination.

Consent status: If the consent is expired, revoked, failed, or suspended, this endpoint returns 400 with code consent_not_active.

Pagination

Use the keyset value from the last transaction in the current page as the after parameter in your next request to fetch the next page. The pagination.more? field indicates if more records are available.

Filtering

Transactions can be filtered by:

  • Amount range (min/max)
  • Currency
  • Booking date range
  • Account ID
  • Credit/debit indicator
  • Transaction status

Body Parameters

client_idstring Required

API client identifier

Max length
128
client_secretstring

API client secret for authentication. Required for internal (non-OAuth2) authentication mode (e.g., test-only). Not required when using OAuth2 (Bearer token) authentication.

Max length
128
consent_idstring Required

Consent ID to filter transactions

filterobject

Filter criteria for listing transactions. All filters are optional and combined with AND logic.

Show child attributes

paginationobject

Pagination parameters for list endpoints using keyset-based pagination. Keyset pagination provides stable, efficient pagination that works well with large datasets and concurrent updates.

Show child attributes

track_changesboolean

Track changes by updated_at instead of inserted_at

Default value
false

Response

200
Object
Transactions retrieved successfully

Response Attributes

api_client_appstring

Name of the API client application

client_idstring

API client identifier

request_idstring

Unique identifier for the API request

consent_idstring

ID of the consent these transactions belong to

transactionsarray

List of transactions matching the filter criteria

Show child attributes

paginationobject

Pagination metadata included in list responses

Show child attributes

400
Object
Validation error or invalid request

Response Attributes

error_idstring Required

Unique identifier for this error instance

request_idstring Required

Request identifier for tracking and correlation

codestring Required

Machine-readable error code for 400 errors:

  • bad_request: Generic validation or request error
  • validation_error: Request payload validation failed
  • invalid_input: Invalid input data provided
  • unprocessable_entity: Valid request but cannot be processed
  • cooldown_failed: Data refresh cooldown period not yet elapsed
  • consent_not_active: Consent is not usable...
Enum values:
bad_requestvalidation_errorinvalid_inputunprocessable_entitycooldown_failedconsent_not_activemethod_selection_errormethod_input_validation_errorlink_expired
messagestring Required

Human-readable error message

401
Object
Authentication failed

Response Attributes

error_idstring Required

Unique identifier for this error instance

request_idstring Required

Request identifier for tracking and correlation

codestring Required

Machine-readable error code for 401 errors:

  • unauthorized: Authentication failed or insufficient permissions
Enum values:
unauthorized
messagestring Required

Human-readable error message

404
Object
Resource not found

Response Attributes

error_idstring Required

Unique identifier for this error instance

request_idstring Required

Request identifier for tracking and correlation

codestring Required

Machine-readable error code for 404 errors:

  • not_found: Generic resource not found
  • consent_not_found: Specified consent does not exist
  • job_not_found: Specified job does not exist or outside accessible date range
Enum values:
not_foundconsent_not_foundjob_not_found
messagestring Required

Human-readable error message

Was this section helpful?

What made this section unhelpful for you?

POST

/

Select
1

Response

Was this section helpful?

What made this section unhelpful for you?

View as Markdown

Ask an AI

Open in ChatGPTOpen in ClaudeOpen in Perplexity

Code with AI

Open in Copilot