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

# Resolve payer names

POST https://api.taigabilling.com/api/prices/v1/payers/resolve
Content-Type: application/json

Matches up to 200 payer names from your system to pricing payer ids. Read-only and safe to retry.

Reference: https://docs.taigabilling.com/api-reference/prices/resolve-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

### Body (application/json)

This endpoint expects a PayerResolveRequest.

- `queries` (list of string, required) — Payer names as they appear in your system.

## Response

### 200

Matches per query

- `data` (list of PayerResolutionDataItems, required) — One entry per query, in request order.
- `object` (enum, required)
  - Allowed values: `list`

## Errors

### 400 Bad Request Error

The request could not be completed.

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

### 401 Unauthorized Error

The request could not be completed.

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

### 403 Forbidden Error

The request could not be completed.

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

### 429 Too Many Requests Error

The request could not be completed.

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

### 502 Bad Gateway Error

The request could not be completed.

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

## Types

### PayerResolutionDataItems

- `matches` (list of PayerResolutionDataItemsMatchesItems, required) — Best first; empty when nothing matches.
- `query` (string, required)

### ApiPricesV1PayersResolvePostResponsesContentApplicationJsonSchemaError

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

### PayerResolutionDataItemsMatchesItems

- `name` (string, required)
- `payer_id` (string, required) — Send this as `payer_id` when pricing.
- `score` (double, required) — 1 is an exact match on the name or an alias.

## Examples

**Request**

```json
{
  "queries": [
    "string"
  ]
}
```

**Response**

```json
{
  "data": [
    {
      "matches": [
        {
          "name": "string",
          "payer_id": "string",
          "score": 0.5
        }
      ],
      "query": "string"
    }
  ],
  "object": "list"
}
```

**SDK Code**

```python
import requests

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

payload = { "queries": ["string"] }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.json())
```