# Get organization
URL: https://docs.fluenta.io/en/docs/reference/organization/get-organization
Operation: `getOrganization`
Required permission: `read`

`GET /v1/external/organizations/{organizationId}`

The organization: «país», «zona horaria» and today in its clock, «moneda», «jornada», the módulos’ «descansos», «categorías» and the plan features it has.

Answers the organization in one read: where it is (`country`, `department`, `city`), its clock (`timezone`, with `today` and `currentHour` on it), its `currency`, its `plan`, the `switches` of «Configuración», the «jornada» (`shift`), every «módulo»’s «descansos» (`moduleRestTimes`) and its «categorías» (`categories`).

`organizationId` comes from `getMe` or `listOrganizations`; one that does not exist or is out of the credential’s reach answers 404 `ORGANIZATION_NOT_FOUND`. `getPlan`, `getSettings`, `listCategories` and `listModuleRestTimes` answer its parts on their own.

### 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 |
| --- | --- | --- | --- | --- |
| `organizationId` | path | integer | yes | The organization, from `getMe` or `listOrganizations`. |

### Responses

| Status | Description |
| --- | --- |
| `200` | `ExternalOrganizationDetailDto` |
| `401` | Missing, malformed, unknown, expired or revoked credential: `INVALID_API_TOKEN`. |
| `402` | The organization is blocked: `ORG_BLOCKED`. |
| `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`). |
| `404` | The organization does not exist or is out of the credential’s reach: `ORGANIZATION_NOT_FOUND`. One body for both. |
| `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/{organizationId}' \
  -H 'Authorization: Bearer <your API token>'
```