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

> Retorna as organizações associadas ao usuário autenticado

Retorna todas as organizações às quais o usuário autenticado pertence. Organizações bloqueadas (`blocked_at` definido) são excluídas da resposta.

## Autenticação

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

## Resposta

**items** `array`

Lista de organizações do usuário

**pagination** `object`

**Propriedades**

**total\_count** `integer`

Total de organizações

**max\_page** `integer`

Número máximo de páginas

Cada organização contém:

**id** `string`

ID único da organização

**name** `string`

Nome da organização

**slug** `string`

Slug único para URL

**avatar\_url** `string`

URL do avatar

**bio** `string`

Descrição/biografia

**email** `string`

E-mail de contato

**website** `string`

Site

**status** `string`

Status: `created`, `active`, `blocked`

**next\_review\_threshold** `integer`

Limite de volume antes da próxima revisão

**subscription\_settings** `object`

Configurações de assinaturas

**notification\_settings** `object`

Configurações de notificações

**created\_at** `string`

Data de criação

**onboarded\_at** `string`

Data de conclusão do onboarding

## Exemplo

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

## Resposta de Exemplo

```json theme={null}
{
  "items": [
    {
      "id": "org_abc123",
      "name": "Minha Empresa",
      "slug": "minha-empresa",
      "avatar_url": "https://cdn.chargefy.io/avatars/org_abc123.png",
      "bio": "Empresa de tecnologia",
      "email": "contato@minhaempresa.com.br",
      "website": "https://minhaempresa.com.br",
      "status": "active",
      "next_review_threshold": 0,
      "subscription_settings": {
        "allow_multiple_subscriptions": false,
        "allow_customer_updates": true,
        "proration_behavior": "prorate"
      },
      "notification_settings": {
        "new_sale": true,
        "new_subscription": true
      },
      "created_at": "2025-06-01T08:00:00Z",
      "onboarded_at": "2025-06-02T10:00:00Z"
    }
  ],
  "pagination": {
    "total_count": 1,
    "max_page": 1
  }
}
```


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