---
title: "Get batch errors"
method: GET
path: "/v1/batches/{batch_id}/errors"
tags: ["batches"]
---

# Get batch errors

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

Error handling in batches are handled differently than in a single synchronous request.
You must retrieve the status of your batch by getting a batch and getting an overview of the statuses or you can list errors directly here below to get detailed information about the errors.

## Query parameters

- `page` integer
- `pagesize` integer

## Response `200`

The request was a success.

- ListBatchErrorsResponseBody — A batch errors response body
  - `errors` BatchResponseError[], required — The errors currently associated with the batch
    - `error` string — Error message associated with the shipment.
    - `shipment_id` string — A string that uniquely identifies a ShipEngine resource, such as a carrier, label, shipment, etc.
    - `external_shipment_id` string — An external shipment id associated with the shipment
  - `links` PaginationLink, required — Helpful links to other pages of results
    - `first` Link, required — A link to a related resource, or an empty object if there is no resource to link to
      - `href` string, url — A URL
      - `type` string — The type of resource, or the type of relationship to the parent resource
    - `last` Link, required — A link to a related resource, or an empty object if there is no resource to link to
      - `href` string, url — A URL
      - `type` string — The type of resource, or the type of relationship to the parent resource
    - `prev` OptionalLink, required — A link to a related resource, or an empty object if there is no resource to link to
      - `href` string, url — A URL
      - `type` string — The type of resource, or the type of relationship to the parent resource
    - `next` OptionalLink, required — A link to a related resource, or an empty object if there is no resource to link to
      - `href` string, url — A URL
      - `type` string — The type of resource, or the type of relationship to the parent resource

## Other responses

- `400` — The request contained errors.
- `404` — The specified resource does not exist.
- `500` — An error occurred on ShipEngine's side. > This error will automatically be reported to our engineers.

## Changes

> 5 revisions in range; 1 could not be searched.

- **2026-08-15** `f3a66d204565` — 18 warning
  - added the new `freight_connection_inactive` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `400`
  - added the new `freight_connection_inactive` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `404`
  - added the new `freight_connection_inactive` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `500`
  - added the new `freight_provider_id_required` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `400`
  - …14 more

[Change history](https://skmtc.dev/shipstation/apis/shipengine-api/changes/v1/batches/:batch_id/errors/get.md)

---

[API](https://skmtc.dev/shipstation/apis/shipengine-api.md) · [All operations](https://skmtc.dev/shipstation/apis/shipengine-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/shipstation/shipengine-api/revisions/422fd75e1e35/schema)