# Get station
URL: https://docs.fluenta.io/en/docs/reference/plant/get-station
Operation: `getStation`
Required permission: `read`

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

One «puesto» (station) as the live board reads it now: «operación», seated «operario», current «referencia», units this hour and today.

Answers one «puesto», a numbered station of a «módulo», as its card on the «Tablero en tiempo real» reads now: the «operación» sewn there (`name`), its place in the «módulo» (`position`), the seated «operario» (`operator`, null when empty), the «referencia» it is on (`currentReference`, null when none) and its counts.

Each «puesto» is read as the «Tablero en tiempo real» reads it now: `unitsThisHour` and `hourGoal` are units of the hour `currentHour` names, `unitsToday` units of the plant day `today` names, `color` the «semáforo» (`GRAY`, `RED`, `YELLOW`, `GREEN`), `pausedAt` an ISO 8601 UTC instant, and `currentReference.price` money per unit in the organization’s currency (`getOrganization.currency`).

The answer carries no `today` or `currentHour`: read them from `getSettings`. Every day and hour is on the plant’s own clock, its «zona horaria» (`getSettings.timezone`, an IANA name), never UTC and never the caller’s.

`stationId` comes from `listStations`, `listOrganizationStations` or `getFloor`, or from the `station.id` of an «operario» (`listOperators`, `getOperator`). A «puesto» is `station` in this API’s paths and answers, and `OPERATION` in its error code.

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 |
| --- | --- | --- | --- | --- |
| `stationId` | path | integer | yes | The «puesto»: an `id` of `listStations`, `listOrganizationStations` or `getFloor`, or the `station.id` of an «operario». Named `operationId` where a route filters by it. |
| `organizationId` | path | integer | yes | The organization, from `getMe` or `listOrganizations`. |

### Responses

| Status | Description |
| --- | --- |
| `200` | `ExternalStationDto` |
| `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. `OPERATION_NOT_FOUND`: no «puesto» with that `stationId` in this organization. One body whether it does not exist, was deleted (or its «módulo» was), belongs to another organization or is not a positive integer: never a 400 or a 403. |
| `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}/stations/{stationId}' \
  -H 'Authorization: Bearer <your API token>'
```