---
title: "Initiate batch call"
method: POST
path: "/batch/transactions"
tags: ["Batch"]
---

# Initiate batch call

`POST /batch/transactions`

## Request

- Base URL: `https://api.truelayer-sandbox.com/data/v1`
- URL: `https://api.truelayer-sandbox.com/data/v1/batch/transactions`
- Auth: OAuth 2
  - Authorization code: `https://auth.truelayer.com/token/connect`
  - Token URL: `https://auth.truelayer.com/token/connect` scopes: `accounts`

Initiate collection of data for multiple cards and accounts in one call

## Headers

- `X-Client-Correlation-Id` string
- `X-PSU-IP` string

## Request body

- BatchRequest
  - `from` string, date-time
  - `to` string, date-time
  - `pending` boolean: Set to true to include pending transactions in response
  - `balance` boolean: Set to true to include balances in response
  - `webhook_uri` string, uri: A webhook will be POSTed to the URI if provided
  - `account_ids_whitelist` unknown[]: If included, only accounts matching the provided IDs will be included in response
    - unknown

## Response `202`

Accepted

- AsyncResponse
  - `results_uri` string, uri
  - `status` 'Succeeded' | 'Queued' | 'Running' | 'Failed': Indicates whether the request was successful. 'Queued', 'Running' and 'Failed' can be returned for async requests.
  - `task_id` string

## Other responses

- `400`: Invalid request
- `401`: Unauthorized
- `403`: Access denied
- `404`: Not found
- `429`: Rate limit exceeded
- `500`: Internal server error
- `501`: Not implemented
- `503`: Service unavailable
- `504`: Gateway timeout

---

[API](https://skmtc.dev/truelayer/apis/data-api-v1.md) - [All operations](https://skmtc.dev/truelayer/apis/data-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/truelayer/apis/data-api-v1/revisions/2906fd6d5b2a?raw)