> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chargefy.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Listar programas de afiliados

> Lista os programas da sua organização no modo da chave.

Use a API key da sua organização. Os resultados vêm do mais recente para o mais antigo, limitados a cada lote. Não há contagem total.

**product** `string`

Filtra pelo ID do produto.

**status** `string`

Filtra por `active`, `paused` ou `archived`.

**limit** `integer` (default: 10)

De 1 a 100.

**starting\_after** `string`

ID do último programa do lote anterior.

**ending\_before** `string`

ID para voltar ao lote anterior. Não combine com `starting_after`.

```bash cURL theme={"theme":"css-variables"}
curl -X GET "https://api.chargefy.io/v1/affiliate-programs?status=active&limit=10" \
  -H "Authorization: Bearer {{API_KEY}}"
```

```json 200 theme={"theme":"css-variables"}
{
  "object": "list",
  "data": [
    {
      "id": "afp_7Dk9mQ2vX5rT8pWN",
      "object": "affiliate_program",
      "admission_mode": "manual",
      "affiliate_fee_rate": 2000,
      "attribution_window_days": 30,
      "created_at": "2026-10-27T12:00:00Z",
      "livemode": true,
      "metadata": {},
      "product": "prod_7Dk9mQ2vX5rT8pWN",
      "recurrence_limit": 3,
      "recurrence_mode": "limited",
      "status": "active",
      "updated_at": "2026-10-27T12:00:00Z",
      "version": 1
    }
  ],
  "has_more": false,
  "url": "/v1/affiliate-programs"
}
```

```json 400 theme={"theme":"css-variables"}
{
  "error": {
    "code": "invalid_request",
    "message": "limit must be an integer from 1 to 100.",
    "param": "limit",
    "type": "invalid_request_error"
  }
}
```

```json 403 theme={"theme":"css-variables"}
{
  "error": {
    "code": "permission_denied",
    "message": "You cannot manage this affiliate program.",
    "type": "invalid_request_error"
  }
}
```

## Erros

| Código | Quando acontece | Como corrigir |
| - | - | - |
| `authentication_failed` | A chave não é válida | Confira a chave enviada |
| `permission_denied` | A chave não tem acesso à organização ou à operação | Confira os escopos e a organização |
| `resource_missing` | O programa ou produto não existe no modo e na organização da chave | Confira o ID e use a chave correspondente |
| `invalid_request` | Um campo ou uma combinação de condições é inválida | Corrija o campo indicado em `param` |

## Chargefy for Platforms

> [!WARNING]
>
> Esta seção só se aplica a contas com o produto **Chargefy for Platforms** habilitado. Nesse produto, uma plataforma opera pagamentos para **suas organizações conectadas**.

Use a chave da plataforma e o header `Organization` com o ID da organização conectada dona do produto. A organização conectada precisa estar ativa na sua rede. O programa continua pertencendo à organização conectada e ao modo da chave.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.