---
title: "Get a single batch"
method: GET
path: "/v1/transactions/batches/{batch_id}"
tags: ["Transactions"]
---

# Get a single batch

`GET /v1/transactions/batches/{batch_id}`

Get a single batch

## Path parameters

- `batch_id` string, uuid, required

## Response `200`

Request to get batch completed successfully.

- Batch
  - `batch_id` string, uuid, required
  - `created_at` string, date-time, required
  - `file_name` string, required
  - `record_count` integer, required
  - `records` LocalPaymentRecord[], required
    - `beneficiary_account_number` string, nullable
    - `beneficiary_address_country` string, nullable
    - `beneficiary_address_line1` string, string, required
    - `beneficiary_address_line2` string, string, nullable
    - `beneficiary_address_line3` string, string, nullable
    - `beneficiary_address_line4` string, string, nullable
    - `beneficiary_bank_branch` string, nullable
    - `beneficiary_bic` string, string, required
    - `beneficiary_date_of_birth` string, nullable
    - `beneficiary_email` string, nullable
    - `beneficiary_iban` string, nullable
    - `beneficiary_id_number` string, nullable
    - `beneficiary_id_type` string, nullable
    - `beneficiary_name` string, string, required
    - `beneficiary_nationality` string, nullable
    - `beneficiary_phone` string, nullable
    - `beneficiary_sort_code` string, nullable
    - `beneficiary_type` 'individual' | 'business'
    - `beneficiary_wire_routing_number` string, nullable
    - `external_reference` string, required
    - `instructed_amount` integer, required
    - `purpose` 'charity' | 'commercial_investment' | 'corporate_card' | 'credit_card' | 'dividend' | 'family' | 'financial_services' | 'goods_sold' | 'goods_bought' | 'government' | 'insurance' | 'intergroup_transfer' | 'intra_group_dividends' | 'information_technology' | 'leasing' | 'loan_charges' | 'merchant_settlement' | 'mobile_wallet' | 'non_resident_transfer_between_accounts' | 'none' | 'pension' | 'personal_expenses' | 'prepaid_cards' | 'professional' | 'rental' | 'resident_transfer_between_accounts' | 'salaries' | 'tax' | 'telecommunications' | 'travel' | 'utility_bill', required — Enum representing different payment purposes.
    - `sequence_no` integer, required
    - `source_account_id` string, uuid, required
  - `status` 'Created' | 'Processed', required
  - `total_instructed_amount` integer, required

---

[API](https://skmtc.net/lorum/apis/auth-api.md) · [All operations](https://skmtc.net/lorum/apis/auth-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lorum/auth-api/revisions/f9b8935027e3/schema)