> ## 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/organizations/:id/sub-organizations

> Retorna as organizações filhas diretamente vinculadas à organização

Lista todas as sub-organizações (filhas diretas) vinculadas à organização pai informada. Requer que o usuário autenticado seja membro da organização pai. Os resultados são ordenados da mais recente para a mais antiga.

## Autenticação

Requer **token de usuário (JWT Supabase)** via header `Authorization: Bearer`.

## Parâmetros de Path

**id** `string` *required*

ID da organização pai

## Resposta

**items** `array`

Lista de sub-organizações vinculadas

**Propriedades de cada sub-organização**

**id** `string`

ID da sub-organização

**name** `string`

Nome da sub-organização

**slug** `string`

Slug único da sub-organização

**status** `string`

Status da sub-organização (ex: `created`, `active`, `denied`)

**fee\_percent** `number`

Percentual de taxa cobrado pela organização pai sobre as transações desta filha

**created\_at** `string`

Data de criação do vínculo

## Exemplo

```bash cURL theme={null}
curl -X GET "https://api.chargefy.io/api/v1/organizations/org_abc123/sub-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.organizations.getSubOrganizations('org_abc123');
```

## Resposta de Exemplo

```json theme={null}
{
  "items": [
    {
      "id": "org_xyz789",
      "name": "Loja Parceira",
      "slug": "loja-parceira",
      "status": "active",
      "fee_percent": 0,
      "created_at": "2026-01-15T10:00:00Z"
    }
  ]
}
```


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