---
title: "Get single batch details"
method: GET
path: "/orders/batch/{batchId}"
tags: ["Batch"]
---

# Get single batch details

`GET /orders/batch/{batchId}`

## Path parameters

- `batchId` string, uuid, required — Idenitifer assigned to the order batch.

## Response `200`

Details of a batch

- BatchDetails — Modifiable details of a batch.
  - `processingStatus` 'SUCCESS' | 'CORRUPT_FILE' | 'DUPLICATE_FILE_NAME' | 'NO_FILES_RECEIVED' | 'INPROGRESS' | 'PENDING' | 'TX_COMPLETED' | 'PARTIAL_SUCCESS' | 'FORCE_STOPPED', required
  - `responseFileSent` boolean
  - `responseFileName` string
  - `batchId` string, uuid, required — Idenitifer assigned to the order batch.
  - `fileCreatedDate` string, date-time — The date time when the file was created on SFTP.
  - `filePickupDate` string, date-time — The date time when the file was picked up by the batch process.
  - `fileName` string
  - `orderType` 'POIOrder' | 'MerchantOrder' | 'POIMaintenanceOrder' | 'MerchantMaintenanceOrder' | 'POIAccessoryOrder' | 'AdditionalServicesOrder' | 'HardwareOrder'
  - `retryCount` integer
  - `transactions` BatchLineItem[] — Individual transactions of the batch.
    - `orderId` string, uuid — Verifone allocated ID for the Order.
    - `requestId` string — Unique value per line per file
    - `entityType` 'MERCHANT_COMPANY' | 'MERCHANT_SITE' | 'POI' — The type of entity that the operation is performed on
    - `operation` 'PARTIAL_UPDATE' | 'TRADING_ADDRESS_UPDATE' | 'DELETE' — The operation performed on the entity
    - `entityLogicalId` string — The logical identifier of the entity.This could be a MID or a TID
    - `keyValues` string — Operational parameters defined as key-value pairs
    - `createdDate` string, date-time
    - `status` string — HTTP Status returned by order API
    - `response` string — Response from order API
    - `orderStatus` 'DRAFT' | 'SUBMITTED' | 'INPROGRESS' | 'COMPLETED' | 'CANCELLED' | 'ONHOLD'
  - `completionDate` string, date-time

## Other responses

- `400` — Bad Request
- `401` — Unauthorised Request
- `403` — Forbidden Request.
- `404` — Not Found Request
- `429` — Too Many Requests
- `500` — Internal Error
- `503` — Service Not Available
- `504` — Service Timeout

---

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