---
title: "Fetch a payer by ID"
method: GET
path: "/payers/{id}"
tags: ["Payers"]
---

# Fetch a payer by ID

`GET /payers/{id}`

Retrieves the full record for the payer identified by `{id}`. Use this once you already have a specific payer ID; use `GET /payers` to discover or browse payers.

Requires the `READ_PAYER` permission. The `tenant-id` header is required, but the payer catalog is not tenant-partitioned: any existing payer ID is returned regardless of which `tenant-id` value is supplied — the header is not used to authorize or scope the lookup, only for audit-trail attribution.

Returns a `PayerResponse` with `id`, `externalPayerId`, `sourceId`, and `data` (shaped per `https://schemas.certifyos.com/entities/Payer.schema.json`). This operation is read-only and has no side effects.

## Path parameters

- `id` string, required

## Headers

- `tenant-id` string, required

## Response `200`

The requested payer.

- PayerResponseSchema — A payer record.
  - `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

- `401` — Unauthorized - Authentication required
- `403` — Forbidden - Insufficient permissions
- `404` — Returned if no payer exists with the given `id`.
- `500` — Internal server error

---

[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)