Get settings
getSettingsPermission 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.
Authorization
apiToken An API token created in Configuración › Tokens de API, or a connected app’s access token
In: header
Path Parameters
The organization, from getMe or listOrganizations.
Response Body
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 } ] }}Get plan GET
The organization’s plan: Light or Pro, its plan version, what it allows (reports, «Facturación», «Pausas», «Conectar con IA»…) and the rate limits this API counts a credential against.
Get floor GET
The whole floor in one answer: every «módulo» in the floor’s order, each with its «puestos» (stations) as the live board reads them now. Counted against the heavy rate limit.