---
title: "List all LYOC"
method: GET
path: "/2024-09/couriers/lyoc"
tags: ["Couriers"]
---

# List all LYOC

`GET /2024-09/couriers/lyoc`

LYOC (Link Your Own Courier) allows merchants to connect their existing courier accounts — such as DHL, UPS, FedEx, or Royal Mail — to Easyship, enabling shipments to be rated and labeled using their own negotiated rates.

Use this endpoint to discover which couriers can be linked for a given country and the supported methods of connection. Each result includes a `creation` object that indicates how the courier can be linked for that country: `creation.api: true` means you can link programmatically via `POST /2024-09/courier_accounts`; `creation.ui: true` means linking is available through the Easyship Dashboard; `creation.contact: true` means you need to contact Easyship sales to arrange linkage.

Filter by `country_alpha2` (ISO 3166-1 Alpha-2, e.g. `GB`) or `country_id`. Both are optional — omitting both returns all available LYOC couriers. If both are provided, `country_id` takes precedence.

Required authorization scope: `public.courier:read`

## Query parameters

- `page` integer
- `per_page` integer
- `country_alpha2` string
- `country_id` string

## Response `200`

list of LYOC for a specific country

- LyocList — List of LYOCs
  - `couriers` LYOC[]
    - `key` string — Unique machine-readable identifier for the courier type (e.g. `dhl`, `ups`, `fedex`, `royal-mail`).
    - `name` string — Human-readable display name of the courier (e.g. `DHL`, `UPS`, `FedEx`).
    - `logo_url` string — URL of the Courier logo.
    - `supported_countries` object[]
      - `id` number — Easyship internal country ID.
      - `alpha2` string — Country code in ISO 3166-1 Alpha-2 format (e.g. `GB`, `US`, `SG`).
      - `creation` object — How the courier can be created for the country.
        - `contact` boolean — Contacting Easyship sales representative.
        - `ui` boolean — Easyship UI (Dashboard or LYOC application).
        - `api` boolean — Easyship Public API.
      - `courier_id` string, nullable — The courier account ID of an already-linked account for this country. Non-null indicates an account has been connected via LYOC and can be referenced in other API calls (e.g. `POST /2024-09/manifests`). `null` means no account has been linked yet for this country — use `creation` to determine how to proceed.
  - `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` — country 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)