# List organizations
URL: https://docs.fluenta.io/en/docs/reference/account/list-organizations
Operation: `listOrganizations`
Required permission: `read`

`GET /v1/external/organizations`

The organizations the credential reaches, by name, 50 per page. A credential of an account with platform-wide access searches every organization.

### Authorization

- `apiToken` — Bearer token. An API token created in Configuración › Tokens de API, or a connected app’s access token

Send it as `Authorization: Bearer <your API token>`.

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `search` | query | string | no | Part of the organization’s name, any case. |
| `page` | query | number | no | 1-based page; 50 organizations per page. |

### Responses

| Status | Description |
| --- | --- |
| `200` | `ExternalOrganizationsPageDto` |
| `401` | Missing, malformed, unknown, expired or revoked credential: `INVALID_API_TOKEN`. |
| `403` | The credential lacks the «Permiso» the route names (`INSUFFICIENT_SCOPE`), or the organization’s plan does not include what was asked (`PLAN_LIMIT`): «Conectar con IA» for a connected app, or a report or analytics route whose plan feature a Light organization lacks (a Light of plan version 1 keeps `reports`). |
| `429` | The credential is over its rate limit: `RATE_LIMITED`. Per credential, in fixed windows of 60 seconds: 60 requests in one organization on Light and 120 on Pro; 20 on the heavy reads (the range figures, the whole floor, the month and the pauses); 300 across every organization; 60 on the routes that name no organization. Wait `Retry-After` seconds; a refused request counts against nothing. |

### Example

```bash
curl -X GET 'https://api.fluenta.io/v1/external/organizations' \
  -H 'Authorization: Bearer <your API token>'
```