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

> Lista afiliados ou programas da sua organização.

Use a API key da sua organização. O acesso é permitido apenas quando sua organização é um dos dois lados da parceria.

**side** `string` (default: affiliates)

`affiliates` lista os afiliados da sua organização; `programs` lista os programas dos quais ela participa.

**status** `string`

Filtra por `active` ou `ended`. Sem filtro, retorna ambos.

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

De 1 a 100.

**starting\_after** `string`

ID da última parceria do lote anterior.

**ending\_before** `string`

ID para voltar ao lote imediatamente anterior. Não pode ser combinado com `starting_after`.

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

```json 200 theme={"theme":"css-variables"}
{
  "object": "list",
  "data": [
    {
      "id": "aff_7Dk9mQ2vX5rT8pWN",
      "object": "affiliation",
      "affiliate_organization": "org_5Nq8rT2wX7mK4pV9",
      "created_at": "2026-10-26T12:00:00Z",
      "ended_at": null,
      "ended_by_organization": null,
      "livemode": true,
      "metadata": {},
      "organization": "org_7Dk9mQ2vX5rT8pWN",
      "source": "platform",
      "status": "active",
      "updated_at": "2026-10-26T12:00:00Z"
    }
  ],
  "has_more": false,
  "url": "/v1/affiliations"
}
```

```json 400 theme={"theme":"css-variables"}
{
  "error": {
    "code": "invalid_request",
    "message": "Invalid side, status, limit or cursor.",
    "type": "invalid_request_error"
  }
}
```

```json 401 theme={"theme":"css-variables"}
{
  "error": {
    "code": "authentication_failed",
    "message": "Invalid API key provided.",
    "type": "authentication_error"
  }
}
```

## 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 filhas**.

Use a chave da plataforma e o header `Organization` da organização filha que está consultando ou encerrando a parceria. A filha precisa estar ativa na sua rede.

```bash cURL theme={"theme":"css-variables"}
curl -X GET "https://api.chargefy.io/v1/affiliations?side=affiliates&limit=10" \
  -H "Authorization: Bearer {{PLATFORM_API_KEY}}" \
  -H "Organization: org_7Dk9mQ2vX5rT8pWN"
```


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