---
title: "Get data in batch"
method: GET
path: "/batch/results"
tags: ["Batch"]
---

# Get data in batch

`GET /batch/results`

## Request

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

Get data for multiple cards and accounts following a successful batch call

## Response `200`

OK

- BatchResults
  - `status` 'Succeeded' | 'Queued' | 'Running' | 'Failed', required: Indicates whether the request was successful. 'Queued', 'Running' and 'Failed' can be returned for async requests.
  - `task_id` string, required: A unique ID associated with the task
  - `request` object, required
    - `from` string, date-time
    - `to` string, date-time
  - `results` object, required
    - `accounts` object[]
      - `account_id` string: Unique identifier of the account
      - `transactions` AccountTransaction[]
        - `transaction_id` string, required: TrueLayer's identifier of the transaction in a request. It may change between requests.
        - `normalised_provider_transaction_id` string: TrueLayer's recommended identifier of the transaction in a request. It will not change between requests.
        - `provider_transaction_id` string: Provider's identifier of the transaction in a request. The format of this string will vary across providers.
        - `timestamp` string, datetime, required: Date the transaction was posted on the account.
        - `description` string, required: Original description of the transaction as reported by the provider.
        - `amount` number, required: The transaction value.
        - `currency` 'EUR' | 'GBP' | 'USD' | 'AUD', required: Currency used for this account or transaction
        - `transaction_type` 'DEBIT' | 'CREDIT', required: Type of the transaction.
        - `transaction_category` 'ATM' | 'BILL_PAYMENT' | 'CASH' | 'CASHBACK' | 'CHEQUE' | 'CORRECTION' | 'CREDIT' | 'DIRECT_DEBIT' | 'DIVIDEND' | 'FEE_CHARGE' | 'INTEREST' | 'OTHER' | 'PURCHASE' | 'STANDING_ORDER' | 'TRANSFER' | 'DEBIT' | 'UNKNOWN', required: `ATM`: Deposit or withdrawal of funds using an ATM (Automated Teller Machine)<br/> `BILL_PAYMENT`: Payment of a bill<br/> `CASH`: Cash deposited over the branch counter or using a Cash & Deposit Machines<br/> `CASHBACK`: An option retailers offer to withdraw cash while making a debit card purchase<br/> `CHEQUE`: A document ordering the payment of money from a bank account to another person or organization<br/> `CORRECTION`: Correction of a transaction error<br/> `CREDIT`: Funds added to your account<br/> `DIRECT_DEBIT`: An automatic withdrawal of funds initiated by a third party at regular intervals<br/> `DIVIDEND`: A payment to your account from shares you hold<br/> `FEE_CHARGE`: Fees or charges in relation to a transaction<br/> `INTEREST`: Credit or debit associated with interest earned or incurred<br/> `OTHER`: Miscellaneous credit or debit<br/> `PURCHASE`: A payment made with your debit or credit card<br/> `STANDING_ORDER`: A payment instructed by the account-holder to a third party at regular intervals<br/> `TRANSFER`: Transfer of money between accounts<br/> `DEBIT`: Funds taken out from your account, uncategorised by the bank<br/> `UNKNOWN`: No classification of transaction category known
        - `transaction_classification` string[], required: The classification and sub-classification of the transaction.
        - `merchant_name` string: The merchant name identified in the transaction description.
        - `running_balance` object
          - `amount` number: The transaction value.
          - `currency` 'EUR' | 'GBP' | 'USD' | 'AUD': Currency used for this account or transaction
        - `meta` AccountTransactionMeta
          - `bank_transaction_id` string: This field is deprecated. Please use the top level `provider_transaction_id`.
          - `provider_transaction_category` string
          - `provider_reference` string
          - `provider_merchant_name` string
          - `provider_category` string
          - `address` string
          - `provider_id` string
          - `counter_party_preferred_name` string
          - `counter_party_iban` string
          - `user_comments` string: Revolut only.
          - `debtor_account_name` string: Monzo only.
          - `transaction_type` string: Amex only.
          - `provider_transaction_id` string: Starling only. This field is deprecated. Please use the top level `provider_transaction_id`.
          - `provider_source` string: Starling only.
      - `pending_transactions` AccountTransaction[]
        - `transaction_id` string, required: TrueLayer's identifier of the transaction in a request. It may change between requests.
        - `normalised_provider_transaction_id` string: TrueLayer's recommended identifier of the transaction in a request. It will not change between requests.
        - `provider_transaction_id` string: Provider's identifier of the transaction in a request. The format of this string will vary across providers.
        - `timestamp` string, datetime, required: Date the transaction was posted on the account.
        - `description` string, required: Original description of the transaction as reported by the provider.
        - `amount` number, required: The transaction value.
        - `currency` 'EUR' | 'GBP' | 'USD' | 'AUD', required: Currency used for this account or transaction
        - `transaction_type` 'DEBIT' | 'CREDIT', required: Type of the transaction.
        - `transaction_category` 'ATM' | 'BILL_PAYMENT' | 'CASH' | 'CASHBACK' | 'CHEQUE' | 'CORRECTION' | 'CREDIT' | 'DIRECT_DEBIT' | 'DIVIDEND' | 'FEE_CHARGE' | 'INTEREST' | 'OTHER' | 'PURCHASE' | 'STANDING_ORDER' | 'TRANSFER' | 'DEBIT' | 'UNKNOWN', required: `ATM`: Deposit or withdrawal of funds using an ATM (Automated Teller Machine)<br/> `BILL_PAYMENT`: Payment of a bill<br/> `CASH`: Cash deposited over the branch counter or using a Cash & Deposit Machines<br/> `CASHBACK`: An option retailers offer to withdraw cash while making a debit card purchase<br/> `CHEQUE`: A document ordering the payment of money from a bank account to another person or organization<br/> `CORRECTION`: Correction of a transaction error<br/> `CREDIT`: Funds added to your account<br/> `DIRECT_DEBIT`: An automatic withdrawal of funds initiated by a third party at regular intervals<br/> `DIVIDEND`: A payment to your account from shares you hold<br/> `FEE_CHARGE`: Fees or charges in relation to a transaction<br/> `INTEREST`: Credit or debit associated with interest earned or incurred<br/> `OTHER`: Miscellaneous credit or debit<br/> `PURCHASE`: A payment made with your debit or credit card<br/> `STANDING_ORDER`: A payment instructed by the account-holder to a third party at regular intervals<br/> `TRANSFER`: Transfer of money between accounts<br/> `DEBIT`: Funds taken out from your account, uncategorised by the bank<br/> `UNKNOWN`: No classification of transaction category known
        - `transaction_classification` string[], required: The classification and sub-classification of the transaction.
        - `merchant_name` string: The merchant name identified in the transaction description.
        - `running_balance` object
          - `amount` number: The transaction value.
          - `currency` 'EUR' | 'GBP' | 'USD' | 'AUD': Currency used for this account or transaction
        - `meta` AccountTransactionMeta
          - `bank_transaction_id` string: This field is deprecated. Please use the top level `provider_transaction_id`.
          - `provider_transaction_category` string
          - `provider_reference` string
          - `provider_merchant_name` string
          - `provider_category` string
          - `address` string
          - `provider_id` string
          - `counter_party_preferred_name` string
          - `counter_party_iban` string
          - `user_comments` string: Revolut only.
          - `debtor_account_name` string: Monzo only.
          - `transaction_type` string: Amex only.
          - `provider_transaction_id` string: Starling only. This field is deprecated. Please use the top level `provider_transaction_id`.
          - `provider_source` string: Starling only.
      - `balance` AccountBalance
        - `currency` 'EUR' | 'GBP' | 'USD' | 'AUD', required: Currency used for this account or transaction
        - `available` number: The amount of funds available to the account holder. This takes into account any pending transactions and includes any overdraft facility.
        - `current` number, required: The amount of funds within the account. This does not include any pending transactions.
        - `overdraft` number: Pre-arranged overdraft limit. Available for all “TRANSACTION” and “BUSINESS_TRANSACTION” account types.
        - `update_timestamp` string, datetime: Last update time of the data
    - `cards` object[]
      - `account_id` string: Unique identifier of the account
      - `transactions` CardTransaction[]
        - `transaction_id` string, required: TrueLayer's identifier of the transaction in a request. It may change between requests.
        - `normalised_provider_transaction_id` string: TrueLayer's recommended identifier of the transaction in a request. It will not change between requests.
        - `provider_transaction_id` string: Provider's identifier of the transaction in a request. The format of this string will vary across providers.
        - `timestamp` string, datetime, required: Date the transaction was posted on the account.
        - `description` string, required: Original description of the transaction as reported by the provider.
        - `amount` number, required: The transaction value.
        - `currency` 'EUR' | 'GBP' | 'USD' | 'AUD', required: Currency used for this account or transaction
        - `transaction_type` 'DEBIT' | 'CREDIT', required: Type of the transaction.
        - `transaction_category` 'ATM' | 'BILL_PAYMENT' | 'CASH' | 'CASHBACK' | 'CHEQUE' | 'CORRECTION' | 'CREDIT' | 'DIRECT_DEBIT' | 'DIVIDEND' | 'FEE_CHARGE' | 'INTEREST' | 'OTHER' | 'PURCHASE' | 'STANDING_ORDER' | 'TRANSFER' | 'DEBIT' | 'UNKNOWN', required: `ATM`: Deposit or withdrawal of funds using an ATM (Automated Teller Machine)<br/> `BILL_PAYMENT`: Payment of a bill<br/> `CASH`: Cash deposited over the branch counter or using a Cash & Deposit Machines<br/> `CASHBACK`: An option retailers offer to withdraw cash while making a debit card purchase<br/> `CHEQUE`: A document ordering the payment of money from a bank account to another person or organization<br/> `CORRECTION`: Correction of a transaction error<br/> `CREDIT`: Funds added to your account<br/> `DIRECT_DEBIT`: An automatic withdrawal of funds initiated by a third party at regular intervals<br/> `DIVIDEND`: A payment to your account from shares you hold<br/> `FEE_CHARGE`: Fees or charges in relation to a transaction<br/> `INTEREST`: Credit or debit associated with interest earned or incurred<br/> `OTHER`: Miscellaneous credit or debit<br/> `PURCHASE`: A payment made with your debit or credit card<br/> `STANDING_ORDER`: A payment instructed by the account-holder to a third party at regular intervals<br/> `TRANSFER`: Transfer of money between accounts<br/> `DEBIT`: Funds taken out from your account, uncategorised by the bank<br/> `UNKNOWN`: No classification of transaction category known
        - `transaction_classification` string[], required: The classification and sub-classification of the transaction.
        - `merchant_name` string: The merchant name identified in the transaction description.
        - `running_balance` object
          - `amount` number: The transaction value.
          - `currency` 'EUR' | 'GBP' | 'USD' | 'AUD': Currency used for this account or transaction
        - `meta` object
          - `bank_transaction_id` string: This field is deprecated. Please use the top level `provider_transaction_id`.
          - `provider_transaction_category` string
          - `provider_reference` string
          - `provider_merchant_name` string
          - `provider_category` string
          - `address` string
          - `provider_id` string
          - `counter_party_preferred_name` string
          - `counter_party_iban` string
          - `user_comments` string: Revolut only.
          - `debtor_account_name` string: Monzo only.
          - `transaction_type` string: Amex only.
          - `provider_transaction_id` string: Starling only. This field is deprecated. Please use the top level `provider_transaction_id`.
          - `provider_source` string: Starling only.
          - `cardNumber` string
          - `location` string
      - `pending_transactions` CardTransaction[]
        - `transaction_id` string, required: TrueLayer's identifier of the transaction in a request. It may change between requests.
        - `normalised_provider_transaction_id` string: TrueLayer's recommended identifier of the transaction in a request. It will not change between requests.
        - `provider_transaction_id` string: Provider's identifier of the transaction in a request. The format of this string will vary across providers.
        - `timestamp` string, datetime, required: Date the transaction was posted on the account.
        - `description` string, required: Original description of the transaction as reported by the provider.
        - `amount` number, required: The transaction value.
        - `currency` 'EUR' | 'GBP' | 'USD' | 'AUD', required: Currency used for this account or transaction
        - `transaction_type` 'DEBIT' | 'CREDIT', required: Type of the transaction.
        - `transaction_category` 'ATM' | 'BILL_PAYMENT' | 'CASH' | 'CASHBACK' | 'CHEQUE' | 'CORRECTION' | 'CREDIT' | 'DIRECT_DEBIT' | 'DIVIDEND' | 'FEE_CHARGE' | 'INTEREST' | 'OTHER' | 'PURCHASE' | 'STANDING_ORDER' | 'TRANSFER' | 'DEBIT' | 'UNKNOWN', required: `ATM`: Deposit or withdrawal of funds using an ATM (Automated Teller Machine)<br/> `BILL_PAYMENT`: Payment of a bill<br/> `CASH`: Cash deposited over the branch counter or using a Cash & Deposit Machines<br/> `CASHBACK`: An option retailers offer to withdraw cash while making a debit card purchase<br/> `CHEQUE`: A document ordering the payment of money from a bank account to another person or organization<br/> `CORRECTION`: Correction of a transaction error<br/> `CREDIT`: Funds added to your account<br/> `DIRECT_DEBIT`: An automatic withdrawal of funds initiated by a third party at regular intervals<br/> `DIVIDEND`: A payment to your account from shares you hold<br/> `FEE_CHARGE`: Fees or charges in relation to a transaction<br/> `INTEREST`: Credit or debit associated with interest earned or incurred<br/> `OTHER`: Miscellaneous credit or debit<br/> `PURCHASE`: A payment made with your debit or credit card<br/> `STANDING_ORDER`: A payment instructed by the account-holder to a third party at regular intervals<br/> `TRANSFER`: Transfer of money between accounts<br/> `DEBIT`: Funds taken out from your account, uncategorised by the bank<br/> `UNKNOWN`: No classification of transaction category known
        - `transaction_classification` string[], required: The classification and sub-classification of the transaction.
        - `merchant_name` string: The merchant name identified in the transaction description.
        - `running_balance` object
          - `amount` number: The transaction value.
          - `currency` 'EUR' | 'GBP' | 'USD' | 'AUD': Currency used for this account or transaction
        - `meta` object
          - `bank_transaction_id` string: This field is deprecated. Please use the top level `provider_transaction_id`.
          - `provider_transaction_category` string
          - `provider_reference` string
          - `provider_merchant_name` string
          - `provider_category` string
          - `address` string
          - `provider_id` string
          - `counter_party_preferred_name` string
          - `counter_party_iban` string
          - `user_comments` string: Revolut only.
          - `debtor_account_name` string: Monzo only.
          - `transaction_type` string: Amex only.
          - `provider_transaction_id` string: Starling only. This field is deprecated. Please use the top level `provider_transaction_id`.
          - `provider_source` string: Starling only.
          - `cardNumber` string
          - `location` string
      - `balance` CardBalance
        - `available` string
        - `currency` 'EUR' | 'GBP' | 'USD' | 'AUD': Currency used for this account or transaction
        - `current` number, required
        - `credit_limit` number
        - `last_statement_balance` number
        - `last_statement_date` string, datetime
        - `payment_due` number
        - `payment_due_date` string, datetime
        - `update_timestamp` string, datetime

## Other responses

- `401`: Unauthorized
- `403`: Access denied
- `404`: Not found
- `500`: Internal server error
- `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)