---
title: "Search payers (Thrivory Payer IDs)"
method: GET
path: "/v1/metadata/payers"
tags: ["Metadata"]
---

# Search payers (Thrivory Payer IDs)

`GET /v1/metadata/payers`

Returns payer directory entries. Use `system=internal` to filter to Thrivory payer identifiers.

## Query parameters

- `q` string
- `system` 'Thrivory'
- `limit` integer
- `cursor` string

## Response `200`

List of payers

- Payer[]
  - `id` string, required — Payer ID in the specified system (e.g., 'thrivoryid:123456')
  - `system` 'Thrivory', required — Identifier system
  - `name` string, required
  - `aliases` string[]

## Other responses

- `400` — 400 Bad Request
- `401` — 401 Unauthorized
- `500` — 500 Server Error

## Changes

- **2025-10-10** `9893450caa9b` — 1 breaking, 1 warning, 2 info
  - removed the enum value `stedi` from the `query` request parameter `system`
  - added the new `Thrivory` enum value to the `items/system` response property for the response status `200`
  - added the new enum value `Thrivory` to the `query` request parameter `system`
  - removed the `stedi` enum value from the `items/system` response property for the response status `200`
- **2025-09-11** `d3470b9a79f0` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/thrivory-com/apis/thrivory-thrivenow-api/changes/v1/metadata/payers/get.md)

---

[API](https://skmtc.dev/thrivory-com/apis/thrivory-thrivenow-api.md) · [All operations](https://skmtc.dev/thrivory-com/apis/thrivory-thrivenow-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/thrivory-com/thrivory-thrivenow-api/revisions/9893450caa9b/schema)