API Reference
Asset librariesConsole
  1. Data API v3
  2. Accounts

Create a Transactions Request

post
https://api.truelayer-sandbox.com/v3/connected-accounts//transactions/requests

Creates an asynchronous request to retrieve transactions for an account over a date range.

The request is processed asynchronously: a 202 response returns the request id (use this value as {request_id} when polling) and an initial status of pending. Poll for the result using the returned id.

Results are paginated and returned in a stable order: by timestamp descending, then id descending as a unique tie-breaker. Pass the next_cursor from a previous page as cursor to retrieve the next page; a null next_cursor means there are no further transactions.

This API must be called using a client_credentials bearer token.

Note: from/to applies to settled transactions. Returned pending transactions may have dates outside the requested range — behaviour varies by bank.

Path Params
string
required

The unique identifier of the account.

Body Params
date
required

The start of the date range (inclusive) for which to retrieve transactions, in YYYY-MM-DD format.

date
required

The end of the date range (inclusive) for which to retrieve transactions, in YYYY-MM-DD format.

string

cursor used for pagination purposes that represents the first item of the page.
Returned as next_cursor in the response payload of endpoints supporting pagination.
Not required to access the first page of items.

integer
1 to 500
Defaults to 50

The maximum number of transactions to return per page. Optional; if omitted, defaults to 50.
The server returns min(500, requested) items.

enrichment
object

Configures the enrichments to perform on the retrieved transactions.
Currently both must be true; individual enrichments are not yet supported.

Headers
string
required

The unique identifier of the data connection.

string

Used to collect and record the end-user's IP address.
The first IP address in the list will be used as the end-user IP address.
Necessary to overcome 4 calls per day rate limits.

string
enum
Defaults to application/json; charset=UTF-8

Generated from available response content types

Allowed:
Responses

Updated about 2 months ago

Did this page help you?
Language
Credentials
OAuth2
URL
LoadingLoading…
Response
Choose an example:
application/json; charset=UTF-8
application/problem+json; charset=UTF-8

Updated about 2 months ago

Did this page help you?