FluentaAPI

Get operator efficiency

getOperatorEfficiencyPermiso read

One operario’s «Eficiencia» per day over a range of up to 92 plant days: their own marcas against their share of each puesto-hour’s meta.

GET/v1/external/organizations/{organizationId}/operators/{operatorId}/analytics/efficiency

What it is: one «operario»’s «Eficiencia» day by day, the chart of that person’s report in the dashboard («Reportes», by «operario»). Each entry of days is one plant day: units are the «marcas» that person registered, at whichever «puestos» they sat; goal is their share of the «meta» of every «puesto»-hour they marked in, 2 decimals (when two people shared a «puesto» in one hour, each takes the part of its «meta» that matches their part of its units); efficiency is units × 100 ÷ the unrounded goal.

This is the person’s figure, the one the «Clasificación» ranks by. It is not a «puesto»’s: two «operarios» who shared a «puesto» add up to that «puesto»’s units and goal.

efficiency is «Eficiencia»: units made × 100 ÷ the «meta» of the same span, a percentage with 2 decimals (100 = exactly the goal, it can pass 100; never a 0–1 ratio), null where the goal is 0. Every «puesto» counts towards it, a «puesto de salida» or not.

Range: from and to are plant days, both included, at most 92 days apart counting both (RANGE_TOO_LARGE past it); for a longer span, ask consecutive ranges. days is oldest first, and a day with no work in the range is no row, not a row of zeros.

Days and hours are the plant’s own: a plant day is a calendar day YYYY-MM-DD in the organization’s timezone (getOrganization timezone), never UTC, and an hour is the clock hour 0–23 that starts at it in that zone.

Plan: needs the plan feature operatorReports (the «operario» reports), the one its dashboard screen is gated by. Pro, a trial of Pro and an «exenta» organization answer it; a Light organization, of either plan version, does not: 403 PLAN_LIMIT with feature: "operatorReports". getPlan features lists what the organization’s plan has.

Heavy read: besides the credential’s ordinary budget it spends the heavy one, 20 requests per 60 seconds per credential and organization; past it the answer is 429 RATE_LIMITED with Retry-After.

See also: getOperatorReport for the same days plus one day hour by hour; getLeaderboard for every «operario» on one day.

Autorización

apiToken
AutorizaciónBearer <token>

An API token created in Configuración › Tokens de API, or a connected app’s access token

En: header

Parámetros de ruta

operatorId*integer

The «operario»: the id of one from listOperators. Unknown or of another organization: 404 OPERATOR_NOT_FOUND.

organizationId*integer

The organization, from getMe or listOrganizations.

Parámetros de consulta

from*string

First plant day of the range, YYYY-MM-DD on the plant’s own clock, included. At most 92 days from from to to, counting both: past it, 400 RANGE_TOO_LARGE.

Patrón^\d{4}-\d{2}-\d{2}$
Longitudlength <= 10
to*string

Last plant day of the range, YYYY-MM-DD on the plant’s own clock, included. Before from: 400 RANGE_INVALID.

Patrón^\d{4}-\d{2}-\d{2}$
Longitudlength <= 10

Respuestas

application/json

application/json

curl -X GET "https://api.fluenta.io/v1/external/organizations/0/operators/0/analytics/efficiency?from=2026-10-01&to=2026-10-31" \  -H "Authorization: Bearer fluenta_live_XXXX"
{  "operator": {    "id": 0,    "name": "string"  },  "from": "string",  "to": "string",  "days": [    {      "day": "string",      "units": 0,      "goal": 0,      "efficiency": 0    }  ]}