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

---

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