TRtruelayer
Accounts

Get a Transactions Request

Retrieves the result of a previously created transactions request.

The response status is one of:

  • pending — the request is still being processed; poll again.
  • completed — the result is available in result.
  • failed — the request could not be completed; see failure_reason.

This endpoint is idempotent and re-readable: repeated reads of the same request_id return the same pre-computed page. To retrieve a different page, create a new request via POST with the next_cursor value, which returns a new request_id.

This API must be called using a client_credentials bearer token.

get/v3/connected-accounts/{account_id}/transactions/requests/{request_id}

Request

  • Base URL
    https://api.truelayer-sandbox.com
  • URL
    https://api.truelayer-sandbox.com/v3/connected-accounts/{account_id}/transactions/requests/{request_id}
  • 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.

request_idstring uuid required

The unique identifier of the transactions request, as returned when the request was created.

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.

Response

Transactions Request

OR
OR

Example response

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "status": "completed",
  "result": {
    "items": [
      {
        "id": "1d6f5f1b9b0e4c0a8f2d3e4b5a6c7d8e",
        "timestamp": "2025-04-01T12:34:56Z",
        "description": "ANKH-MORPORK POST OFFICE",
        "currency": "GBP",
        "amount_in_minor": -4200,
        "status": "settled"
      }
    ],
    "pagination": {
      "next_cursor": "bWFuZGF0ZXM6MmUwNDk0MTMK"
    }
  }
}

Changes

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