---
title: "List all Batch Items"
method: GET
path: "/2024-09/batches/{batch_id}/items"
tags: ["Batches"]
---

# List all Batch Items

`GET /2024-09/batches/{batch_id}/items`

Retrieve a list of all batches ordered by date of creation.

Required authorization scope: `public.batch:read`

## Path parameters

- `batch_id` string, required

## Query parameters

- `page` integer
- `per_page` integer

## Response `200`

list of batches

- BatchItemList — List of Batches
  - `batch_items` BatchItem[]
    - `id` string, uuid — Batch Item ID
    - `type` 'address_batch_item' | 'shipment_batch_item' | 'label_batch_item' — Batch Item type
    - `reference_id` string, nullable
    - `state` 'created' | 'processing' | 'processed' | 'failed' — Batch state
    - `record_type` string, nullable
    - `record_id` string, uuid, nullable
    - `processing_errors` string[]
    - `finished_at` string, datetime, nullable
    - `created_at` string, datetime
    - `updated_at` string, datetime
  - `meta` MetaWithPagination
    - `pagination` Pagination — Pagination
      - `next` integer, nullable
      - `count` integer, nullable — The total number of items. The `null` value is used with countless pagination (used for faster response on large datasets, like shipments).
      - `page` integer — Current page
    - `request_id` string — An unique ID represent the request.

## Other responses

- `404` — record not found

---

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