TRtruelayer
Accounts

Create a Transactions Request

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.

post/v3/connected-accounts/{account_id}/transactions/requests

Request

  • Base URL
    https://api.truelayer-sandbox.com
  • URL
    https://api.truelayer-sandbox.com/v3/connected-accounts/{account_id}/transactions/requests
  • Auth
    OAuth 2
    Client credentials
    Token URL: https://auth.truelayer.com/connect/token scopes: data

Path parameters

account_idstring required

The unique identifier of the account.

Headers

Connection-Idstring required

The unique identifier of the data connection.

Tl-User-IPstring

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.

Request body

fromstring date required

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

tostring date required

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

cursorstring

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.

page_sizeinteger

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

Example request

{
  "from": "2025-04-01",
  "to": "2026-04-01",
  "cursor": "bWFuZGF0ZXM6MmUwNDk0MTMK",
  "page_size": 100,
  "enrichment": {
    "transaction_category": true,
    "merchant_name": true
  }
}

Response

Transactions Request Accepted

idstring uuid required

The unique identifier of the transactions request.

status'pending' required

The transactions request is still being processed. Poll again to retrieve the result.

Example response

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "status": "pending"
}

Changes

No recorded changes to this operation across all 1 revision of this API.