---
title: "Changes to Get Batch By External ID"
method: GET
path: "/v1/batches/external_batch_id/{external_batch_id}"
---

# Changes to Get Batch By External ID

`GET /v1/batches/external_batch_id/{external_batch_id}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 6 of 70 revisions.

- **2024-10-16** `97d4f65fe53d`: 2 warning
- **2024-10-08** `e4ae9b442f54`: 12 info
- **2024-09-13** `5a15ef11fd60`: 28 warning
- **2024-05-01** `46a58a889a57`: 1 info
- **2024-03-21** `9c7925506c11`: 20 warning
- **2024-02-14** `c1c8f9dca5b7`: 1 info

## Changes

- **2024-10-16** `97d4f65fe53d`: 2 warning
  - added the new `A4` enum value to the `allOf[subschema #1: batch]/label_layout/allOf[subschema #1: label_layout]/` response property for the response status `200`
  - added the new `A6` enum value to the `allOf[subschema #1: batch]/label_layout/allOf[subschema #1: label_layout]/` response property for the response status `200`
- **2024-10-08** `e4ae9b442f54`: 12 info
  - added the optional property `allOf[subschema #1: batch]/process_errors/items/allOf[subschema #1: error]/carrier_code` to the response with the `200` status
  - added the optional property `allOf[subschema #1: batch]/process_errors/items/allOf[subschema #1: error]/carrier_id` to the response with the `200` status
  - added the optional property `allOf[subschema #1: batch]/process_errors/items/allOf[subschema #1: error]/field_name` to the response with the `200` status
  - added the optional property `errors/items/allOf[subschema #1: error]/carrier_code` to the response with the `400` status
  - added the optional property `errors/items/allOf[subschema #1: error]/carrier_code` to the response with the `404` status
  - added the optional property `errors/items/allOf[subschema #1: error]/carrier_code` to the response with the `500` status
  - added the optional property `errors/items/allOf[subschema #1: error]/carrier_id` to the response with the `400` status
  - added the optional property `errors/items/allOf[subschema #1: error]/carrier_id` to the response with the `404` status
  - added the optional property `errors/items/allOf[subschema #1: error]/carrier_id` to the response with the `500` status
  - added the optional property `errors/items/allOf[subschema #1: error]/field_name` to the response with the `400` status
  - added the optional property `errors/items/allOf[subschema #1: error]/field_name` to the response with the `404` status
  - added the optional property `errors/items/allOf[subschema #1: error]/field_name` to the response with the `500` status
- **2024-09-13** `5a15ef11fd60`: 28 warning
  - added the new `file_not_found` enum value to the `allOf[subschema #1: batch]/process_errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `200`
  - added the new `file_not_found` 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 `file_not_found` 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 `file_not_found` 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 `funding_source_error` enum value to the `allOf[subschema #1: batch]/process_errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `200`
  - added the new `funding_source_error` 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 `funding_source_error` 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 `funding_source_error` 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 `funding_source_missing_configuration` enum value to the `allOf[subschema #1: batch]/process_errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `200`
  - added the new `funding_source_missing_configuration` 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 `funding_source_missing_configuration` 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 `funding_source_missing_configuration` 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 `funding_source_registration_in_progress` enum value to the `allOf[subschema #1: batch]/process_errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `200`
  - added the new `funding_source_registration_in_progress` 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 `funding_source_registration_in_progress` 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 `funding_source_registration_in_progress` 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 `insurance_failure` enum value to the `allOf[subschema #1: batch]/process_errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `200`
  - added the new `insurance_failure` 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 `insurance_failure` 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 `insurance_failure` 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 `service_not_determined` enum value to the `allOf[subschema #1: batch]/process_errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `200`
  - added the new `service_not_determined` 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 `service_not_determined` 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 `service_not_determined` 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 `shipping_rule_not_found` enum value to the `allOf[subschema #1: batch]/process_errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `200`
  - added the new `shipping_rule_not_found` 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 `shipping_rule_not_found` 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 `shipping_rule_not_found` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `500`
- **2024-05-01** `46a58a889a57`: 1 info
  - added the required property `allOf[subschema #1: batch]/paperless_download` to the response with the `200` status
- **2024-03-21** `9c7925506c11`: 20 warning
  - added the new `customs_items_required` enum value to the `allOf[subschema #1: batch]/process_errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `200`
  - added the new `customs_items_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`
  - added the new `customs_items_required` 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 `customs_items_required` 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 `incompatible_paired_labels` enum value to the `allOf[subschema #1: batch]/process_errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `200`
  - added the new `incompatible_paired_labels` 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 `incompatible_paired_labels` 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 `incompatible_paired_labels` 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 `invalid_charge_event` enum value to the `allOf[subschema #1: batch]/process_errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `200`
  - added the new `invalid_charge_event` 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 `invalid_charge_event` 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 `invalid_charge_event` 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 `invalid_object` enum value to the `allOf[subschema #1: batch]/process_errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `200`
  - added the new `invalid_object` 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 `invalid_object` 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 `invalid_object` 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 `no_rates_returned` enum value to the `allOf[subschema #1: batch]/process_errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `200`
  - added the new `no_rates_returned` 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 `no_rates_returned` 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 `no_rates_returned` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `500`
- **2024-02-14** `c1c8f9dca5b7`: 1 info
  - added the required property `allOf[subschema #1: batch]/process_errors` to the response with the `200` status

---

[Operation](https://skmtc.dev/shipengine/apis/shipengine-api/docs/v1/batches/external_batch_id/:external_batch_id/get.md) - [API](https://skmtc.dev/shipengine/apis/shipengine-api.md) - [Page](https://skmtc.dev/shipengine/apis/shipengine-api/changes/v1/batches/external_batch_id/:external_batch_id/get)