> ## Documentation Index
> Fetch the complete documentation index at: https://scaleup-c34c4386.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# GET /api/v1/sdk/organizations

> Retorna a lista de sub-organizações filhas vinculadas à organização pai autenticada.

Retorna todas as sub-organizações criadas e gerenciadas pela organização pai. Útil para plataformas que gerenciam múltiplos vendedores ou clientes como sub-organizações dentro do ecossistema Chargefy.

## Autenticação

Requer **Organization Access Token (OAT)** da organização pai via header `Authorization: Bearer`.

## Resposta

**items** `array`

Lista de sub-organizações vinculadas à organização pai.

**items\[]**

**id** `string`

Identificador único da sub-organização.

**name** `string`

Nome da sub-organização.

**status** `string`

Status atual da sub-organização (ex.: `active`, `inactive`).

## Exemplo

```bash cURL theme={null}
curl -X GET "https://api.chargefy.io/api/v1/sdk/organizations" \
  -H "Authorization: Bearer $CHARGEFY_ACCESS_TOKEN"
```

```typescript SDK theme={null}
import { Chargefy } from '@chargefy/sdk';
const chargefy = new Chargefy({ accessToken: process.env.CHARGEFY_ACCESS_TOKEN });
const result = await chargefy.sdk.organizations.list();
```

## Resposta de Exemplo

```json theme={null}
{
  "items": [
    {
      "id": "org_01j9abc111",
      "name": "Vendedor Alpha",
      "status": "active"
    },
    {
      "id": "org_01j9abc222",
      "name": "Vendedor Beta",
      "status": "active"
    }
  ]
}
```


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