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

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

The plant’s «jornada»: its «zona horaria» and today in its clock, when the shift starts and ends on each weekday, the «jornada continua» and «jornada especial» days, the days off, and its switches. The «descansos» of a «módulo» are `listModuleRestTimes`.

Answers what «Configuración» shows under «Jornada», «Zona horaria» and the switches of «Aplicación». Read it first when a question depends on when the plant works, or on what «hoy» is.

`timezone` is the plant’s «zona horaria» (an IANA name, e.g. `America/Bogota`). `today` (`YYYY-MM-DD`) and `currentHour` (0 to 23) are that clock now: the day to send wherever a route takes a `day`. In `shift`, every time is minutes from midnight on that clock (330 is 05:30), every weekday is 0 Sunday to 6 Saturday, and every day is `YYYY-MM-DD`: `startMin` for every worked day, `endMinsByWeekday` per weekday (null: not worked), `continuousDays` the «jornada continua» weekdays (no «descanso» applies), `specialDays` the «jornada especial» dates with the minute each ends at, `holidays` the days off the plant added by hand, `nationalHolidays` its country’s holidays (a day off unless `worked`) and `workedHolidays` the national holidays it works.

A plant that never saved its «jornada» answers `shift.configured: false`, a null `startMin` and empty lists; the read creates nothing. `switches` are the effective flags: stored on and allowed by the plan.

The «descansos» are not here: they belong to each «módulo» (`listModuleRestTimes`, with a `moduleId` from `listModules`).

Not paged: the whole answer comes in one response.

Plan: on every plan, Light included. A «token de API» reads it in any organization the user who created it belongs to; a connected AI app (a «conexión») reads it only where the organization has «Conectar con IA» (`getPlan.features.aiConnector`, a Pro feature), and answers 403 `PLAN_LIMIT` elsewhere.

Rate limit: one request of the credential’s ordinary budget in this organization (`getPlan` answers the numbers); past it, 429 `RATE_LIMITED` with `Retry-After` in seconds.

### 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` | `ExternalSettingsDto` |
| `401` | `INVALID_API_TOKEN`: the credential is missing, malformed, unknown, expired or revoked. One body for all of them. |
| `402` | The organization is blocked: `ORG_BLOCKED`. |
| `403` | `PLAN_LIMIT` with `feature: "aiConnector"`: the credential is a «conexión» and the organization’s plan has no «Conectar con IA» (Light). A «token de API» is not refused here on any plan on sale: the plant reads are on every plan. `INSUFFICIENT_SCOPE` only for a credential without the «Permiso» `read` («Leer»), which every credential is issued with. |
| `404` | `ORGANIZATION_NOT_FOUND`: the organization does not exist or is out of the credential’s reach. 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}/settings' \
  -H 'Authorization: Bearer <your API token>'
```