# Search references
URL: https://docs.fluenta.io/docs/reference/program/search-references
Operation: `searchReferences`
Required permission: `read`

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

Search the organization’s referencias by «Corte (OC)», «Referencia» or «Categoría», optionally in one módulo or one state (in the «Programa», on hold, finished). 50 per page, newest first.

Searches the organization’s «referencias» (cuts, OCs) across every «módulo» and every state: in a «Programa», in the «banco de espera» or finished. `search` matches part of the «Corte (OC)», of the «Referencia» name or of the «Categoría»; `moduleId` and `status` narrow the answer.

Paged: 50 per page, newest first, as `{items, page, total}`; `total` counts every match. A `moduleId` that is unknown or belongs to another organization answers 404 `MODULE_NOT_FOUND`. Each `id` is the `referenceId` of `getReference`.

### 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 |
| --- | --- | --- | --- | --- |
| `search` | query | string | no | Part of the «Corte (OC)», the «Referencia» name or the «Categoría» (garment), any case. Omitted: every referencia matches. |
| `moduleId` | query | integer | no | Only the referencias of this módulo (an id from `listModules`). |
| `status` | query | string | no | `in_program`: in a módulo’s «Programa», not finished. `on_hold`: in the «banco de espera». `finished`: closed. Omitted: all three. One of: `in_program`, `on_hold`, `finished`. |
| `page` | query | integer | no | 1-based page; 50 referencias per page, newest first. |
| `organizationId` | path | integer | yes | The organization, from `getMe` or `listOrganizations`. |

### Responses

| Status | Description |
| --- | --- |
| `200` | `ExternalReferencePageDto` |
| `401` | Missing, malformed, unknown, expired or revoked credential: `INVALID_API_TOKEN`. |
| `402` | The organization is blocked: `ORG_BLOCKED`. |
| `403` | The credential lacks the «Permiso» the route names (`INSUFFICIENT_SCOPE`), or the organization’s plan does not include what was asked (`PLAN_LIMIT`): «Conectar con IA» for a connected app, or a report or analytics route whose plan feature a Light organization lacks (a Light of plan version 1 keeps `reports`). |
| `404` | The organization does not exist or is out of the credential’s reach: `ORGANIZATION_NOT_FOUND`. 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}/references' \
  -H 'Authorization: Bearer <your API token>'
```