> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.taigabilling.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.taigabilling.com/_mcp/server.

# List pricing payers

GET https://api.taigabilling.com/api/prices/v1/payers

Searches the payers supported for pricing. Send a payer's `id`, any alias `value` or its exact name as `payer_id`.

Reference: https://docs.taigabilling.com/api-reference/prices/list-price-payers

## Authentication

- `Authorization` header (bearer token, required) — Send your Taiga API key as a Bearer token. Create and manage keys in the Taiga developer portal.

## Servers

- `https://api.taigabilling.com` (Production, default)
- `https://api-staging.taigabilling.com` (Staging)

## Request

### Query parameters

- `q` (string, optional) — Case-insensitive substring match on the payer name.
- `limit` (integer, optional, default: 25)
- `starting_after` (string, optional) — The `id` of the last payer on the previous page.

## Response

### 200

Payers

- `data` (list of Payer, required)
- `has_more` (boolean, required)
- `object` (enum, required)
  - Allowed values: `list`

## Errors

### 400 Bad Request Error

The request could not be completed.

- `message` (string, required)
- `error` (ApiPricesV1PayersGetResponsesContentApplicationJsonSchemaError, optional)

### 401 Unauthorized Error

The request could not be completed.

- `message` (string, required)
- `error` (ApiPricesV1PayersGetResponsesContentApplicationJsonSchemaError, optional)

### 403 Forbidden Error

The request could not be completed.

- `message` (string, required)
- `error` (ApiPricesV1PayersGetResponsesContentApplicationJsonSchemaError, optional)

### 429 Too Many Requests Error

The request could not be completed.

- `message` (string, required)
- `error` (ApiPricesV1PayersGetResponsesContentApplicationJsonSchemaError, optional)

### 502 Bad Gateway Error

The request could not be completed.

- `message` (string, required)
- `error` (ApiPricesV1PayersGetResponsesContentApplicationJsonSchemaError, optional)

## Types

### Payer

- `aliases` (list of PayerAliasesItems, required) — Other identifiers for this payer; any `value` is accepted as `payer_id`.
- `id` (string, required)
- `name` (string, required)
- `object` (enum, required)
  - Allowed values: `payer`

### ApiPricesV1PayersGetResponsesContentApplicationJsonSchemaError

- `candidates` (list of string, optional) — Matching payer ids when `payer_id` was ambiguous.
- `code` (string, optional)
- `message` (string, optional)
- `param` (string, optional) — The request field at fault.
- `retryable` (boolean, optional) — Retry unchanged only when true.
- `type` (string, optional)

### PayerAliasesItems

- `kind` (string, required)
- `value` (string, required)

## Examples

**Response**

```json
{
  "data": [
    {
      "aliases": [
        {
          "kind": "string",
          "value": "string"
        }
      ],
      "id": "string",
      "name": "string",
      "object": "payer"
    }
  ],
  "has_more": true,
  "object": "list"
}
```

**SDK Code**

```python
import requests

url = "https://api.taigabilling.com/api/prices/v1/payers"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.json())
```