# Listar (/docs/developers/api-reference/employer-registrations/list)

## Descripcion general [#descripcion-general]

Este endpoint permite obtener un listado paginado de los registros patronales (IMSS) pertenecientes a tu organización. Los resultados se devuelven en formato JSON e incluyen metadatos de paginación. Cada registro está vinculado a una razón social mediante `legal_entity_number`. Los registros eliminados se excluyen automáticamente. El tamaño de página es fijo en 20 resultados.

`risk_premium` se serializa como **string decimal** (por ejemplo `"0.0054355"`) para preservar la precisión. `premium_effective_from` se serializa como timestamp ISO 8601.

## Endpoint [#endpoint]

`GET https://app.integranom.com/api/v1/employer-registrations`

## Consulta multiples registros patronales [#consulta-multiples-registros-patronales]

***

## Query params [#query-params]

| Parametro             | Tipo                  | Requerido | Default | Descripcion                                           |
| --------------------- | --------------------- | --------- | ------- | ----------------------------------------------------- |
| `page`                | integer ≥ 1           | No        | 1       | Página solicitada. El tamaño de página es fijo en 20. |
| `legal_entity_number` | integer               | No        | -       | Restringe los resultados a una sola razón social.     |
| `active`              | `"true"` \| `"false"` | No        | -       | Filtra por el flag `is_active`.                       |

**cURL**

```bash
curl -X GET "https://app.integranom.com/api/v1/employer-registrations" \
-H "Authorization: Bearer TU_API_KEY" \
-H "Content-Type: application/json"
```

**Respuesta**

```json
{
"count": 4,
"page": 1,
"page_size": 20,
"total_pages": 1,
"next": null,
"previous": null,
"results": [
  {
    "employer_registration_number": 1,
    "legal_entity_number": 1,
    "number": "Y6712345678",
    "label": "RP principal CDMX",
    "risk_class": 1,
    "risk_premium": "0.005",
    "premium_effective_from": "2026-01-01T00:00:00.000Z",
    "is_active": true,
    "created_at": "2026-05-24T10:00:00.000Z",
    "updated_at": "2026-05-24T10:00:00.000Z"
  }
]
}
```

## Consulta un registro patronal especifico [#consulta-un-registro-patronal-especifico]

***

Se puede buscar un registro patronal particular por su número org-scoped o por el número IMSS exacto. El campo `number` distingue mayúsculas y minúsculas.

## Query params [#query-params-1]

| Parametro                      | Tipo    | Requerido | Default | Descripcion                                                |
| ------------------------------ | ------- | --------- | ------- | ---------------------------------------------------------- |
| `employer_registration_number` | integer | No        | -       | Filtra por número org-scoped exacto del registro patronal. |
| `number`                       | string  | No        | -       | Filtra por número IMSS exacto.                             |

**cURL**

```bash
curl -X GET "https://app.integranom.com/api/v1/employer-registrations?employer_registration_number=1" \
-H "Authorization: Bearer TU_API_KEY" \
-H "Content-Type: application/json"
```

**Respuesta**

```json
{
"count": 1,
"page": 1,
"page_size": 20,
"total_pages": 1,
"next": null,
"previous": null,
"results": [
  {
    "employer_registration_number": 1,
    "legal_entity_number": 1,
    "number": "Y6712345678",
    "label": "RP principal CDMX",
    "risk_class": 1,
    "risk_premium": "0.005",
    "premium_effective_from": "2026-01-01T00:00:00.000Z",
    "is_active": true,
    "created_at": "2026-05-24T10:00:00.000Z",
    "updated_at": "2026-05-24T10:00:00.000Z"
  }
]
}
```

## Errores [#errores]

| Status | Causa                                                                                                                                                             |
| ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `400`  | Valor inválido en `employer_registration_number`, `legal_entity_number` o `active`; o `legal_entity_number` no corresponde a una razón social de la organización. |
| `401`  | API key ausente o inválida.                                                                                                                                       |