---
title: "Get all payers"
method: GET
path: "/payers"
tags: ["Payers"]
---

# Get all payers

`GET /payers`

Returns a list of payers for the provided tenant. The payers are returned sorted by creation date, with the most recent payers appearing first.

## Query parameters

- `name` string

## Headers

- `tenant-id` string, required

## Response `200`

Returned if the request is successful.

- GetAllPayersResponse
  - `totalCount` integer
  - `data` PayerSchema[]
    - `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 request is invalid. `tenant-id` and `user-id` headers are required.
- `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 request is a bad gateway. Downstream service error.
- `503` — Returned if the request is a service unavailable. Network connectivity issues.

---

[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/3d27e9019c7b/schema)
