---
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](https://www.shipengine.com/docs/reference/get-batch-by-id/) 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.

---

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