---
title: "List Unavailable Couriers for a Shipment"
method: GET
path: "/2024-09/shipments/{easyship_shipment_id}/unavailable_couriers"
tags: ["Shipments"]
---

# List Unavailable Couriers for a Shipment

`GET /2024-09/shipments/{easyship_shipment_id}/unavailable_couriers`

## Request

- Base URL: `https://public-api.easyship.com`
- URL: `https://public-api.easyship.com/2024-09/shipments/{easyship_shipment_id}/unavailable_couriers`
- Auth: HTTP bearer

List unavailable couriers for a shipment.

Required authorization scopes: `public.shipment:read`, `public.rate:read`

## Path parameters

- `easyship_shipment_id` string, required

## Query parameters

- `page` integer
- `per_page` integer

## Response `200`

list of unavailable couriers for the shipment

- UnavailableCouriersList
  - `unavailable_couriers` object[]
    - `id` string, uuid: unique identifier for a courier service
    - `name` string: Unavailable courier name
    - `message` string: Unavailable reason
  - `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`: shipment not found

---

[API](https://skmtc.dev/easyship/apis/easyship-public-api.md) - [All operations](https://skmtc.dev/easyship/apis/easyship-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/easyship/apis/easyship-public-api/revisions/b47b54b748a7?raw)