---
title: "List payers, sorted by ID ascending"
method: GET
path: "/payers"
tags: ["Payers"]
---

# List payers, sorted by ID ascending

`GET /payers`

Returns a page of payers from the shared payer catalog, ordered by `id` ascending — payer records carry no creation timestamp, so there is no "newest first" ordering. Use this to browse or discover payers before referencing one by ID (e.g. when associating a payer with a plan or network); use `GET /payers/{id}` once you already have a specific payer ID.

Requires the `READ_PAYER` permission. The `tenant-id` header is required, but the payer catalog is not tenant-partitioned: the value is forwarded downstream purely for audit-trail attribution and does not filter or restrict which payers are returned.

**Pagination:** always returns the first 10 records (offset 0); no caller-controlled pagination is currently exposed by this endpoint, even though the underlying payer service supports page/cursor-based pagination. This is a known limitation of this endpoint specifically, not fixed in this change.

Returns a `GetAllPayersResponse` with a `data` array of payer records and a `totalCount`. Each record's own `data` field is shaped per `https://schemas.certifyos.com/entities/Payer.schema.json`. This operation is read-only and has no side effects.

## Query parameters

- `name` string

## Headers

- `tenant-id` string, required

## Response `200`

The requested page of payers, plus the total count of payers in the catalog.

- GetAllPayersResponse
  - `totalCount` integer
  - `data` PayerResponseSchema[]
    - `id` string
    - `externalPayerId` string
    - `sourceId` string
    - `data` PayerSchema — Represents an entity responsible for financing or reimbursing the cost of healthcare services.
      - `name` string, required — Name of the payer
      - `category` string — Type of payer
      - `sourceSystem` 'API' | 'File Upload' — Specifies the origin system of a record.
      - `changeReason` string — Optional description of why a change was made

## Other responses

- `400` — Returned if the `tenant-id` header is missing.
- `401` — Returned if the request is unauthorized. Authentication required.
- `403` — Returned if the request is forbidden. Insufficient permissions.
- `500` — Returned if the request is an internal server error.
- `502` — Returned if the downstream payer service returned an error response.
- `503` — Returned if the downstream payer service is unreachable (network connectivity issue).

---

[API](https://skmtc.net/certifyos/apis/certify-api-layer.md) · [All operations](https://skmtc.net/certifyos/apis/certify-api-layer/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/certifyos/certify-api-layer/revisions/563848e0ecc0/schema)