Get settings
getSettingsPermiso read
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`.
/v1/external/organizations/{organizationId}/settingsAnswers 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.
Autorización
apiToken An API token created in Configuración › Tokens de API, or a connected app’s access token
En: header
Parámetros de ruta
The organization, from getMe or listOrganizations.
Respuestas
application/json
application/json
curl -X GET "https://api.fluenta.io/v1/external/organizations/0/settings" \ -H "Authorization: Bearer fluenta_live_XXXX"{ "timezone": "America/Bogota", "today": "2019-08-24", "currentHour": 0, "switches": { "pausesEnabled": true, "operatorPicksReference": true, "showMoneyOnBoard": true }, "shift": { "configured": true, "startMin": 0, "endMinsByWeekday": [ 0 ], "continuousDays": [ 0 ], "specialDays": [ { "day": "2026-12-19", "endMin": 0, "reason": "string" } ], "holidays": [ "2019-08-24" ], "workedHolidays": [ "2019-08-24" ], "nationalHolidays": [ { "day": "2026-12-08", "name": "Inmaculada Concepción", "worked": true } ] }}