List Transactions

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

Consent status: If the consent is expired, revoked, deactivated, 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.

Sort Order

Transactions are returned sorted by booking_date_time descending (most recent first), then by inserted_at descending within the same booking date, then by id descending as a tiebreaker for keyset pagination. Transactions without a booking date appear last.

Note on booking_date_time granularity:

Most European banks integrated via FinqLink expose PSD2 APIs based on the Berlin Group standard, which only provides transaction booking information as a calendar date (no time-of-day).
FinqLink normalizes this into a full timestamp with the time set to 00:00:00Z.
In practice, many transactions on the same day share the same midnight timestamp; their relative order is determined by inserted_at descending.
booking_date_from / booking_date_to effectively filter by calendar day — always pass values aligned to T00:00:00Z. Any other time-of-day (e.g. 2026-04-17T12:00:00Z) will silently exclude that entire day.
For intra-day filtering (e.g. “transactions that appeared after a specific time today”) use inserted_from / inserted_to instead; they support full time-of-day resolution. The real granularity depends on how often data is refreshed for the consent.

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

DEPRECATED: This field is ignored and will be removed in a future version. All requests now use the same unified query sorted by booking_date_time desc. Use the updated_from/updated_to filter fields for change tracking instead.

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

latest_completed_jobobject | null

Slim summary of the most recently successfully completed AIS data refresh job (full or light) for the consent referenced by the request. null when no job has ever completed for the consent.

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
internal_error: AIS-side unexpected internal error
external_api_unavailable: External provider HTTP failure (timeout, connection refused, DNS, etc.). Surfaced as HTTP 400 instead of a gateway 504.
external_api_error: External provider returned a structured error during the AIS ...

Enum values:

bad_requestvalidation_errorinvalid_inputinternal_errorexternal_api_unavailableexternal_api_errorcooldown_failedconsent_not_activejob_in_progressmethod_selection_error

... 2 other enums

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

Sections

List Transactions

Pagination

Sort Order

Filtering

Body ParametersExpand all

ResponseExpand all

Response Attributes

Response Attributes

... 2 other enums

Response Attributes

Response Attributes

Response

Ask an AI

Code with AI

Body Parameters

Response