# Listar (/docs/developers/api-reference/payroll-calendars/list)

## Descripcion general [#descripcion-general]

Este endpoint permite obtener un listado paginado de los calendarios de nómina de tu organización. Los resultados se devuelven en formato JSON e incluyen metadatos de paginación. Un calendario es **por razón social**: sus periodos son específicos de la razón social a la que pertenece. Los calendarios eliminados se excluyen automáticamente.

## Endpoint [#endpoint]

`GET https://app.integranom.com/api/v1/payroll-calendars`

## Consulta multiples calendarios de nomina [#consulta-multiples-calendarios-de-nomina]

***

Devuelve todos los calendarios de la organización, paginados de 20 en 20. Puedes acotar el listado por frecuencia o por su flag activo.

## 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. |
| `frequency` | `weekly` \| `biweekly` \| `semimonthly` \| `monthly` | No        | -       | Filtra por la frecuencia del calendario.              |
| `active`    | `"true"` \| `"false"`                                | No        | -       | Filtra por el flag `is_active`.                       |

**cURL**

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

**Respuesta**

```json
{
"count": 24,
"page": 1,
"page_size": 20,
"total_pages": 2,
"next": "?page=2",
"previous": null,
"results": [
  {
    "payroll_calendar_number": 3,
    "legal_entity_number": 1,
    "name": "Quincenal 2026",
    "frequency": "semimonthly",
    "isr_tariff_frequency": "semimonthly",
    "applies_seventh_day_discount": true,
    "month_day_factor": 30,
    "anchor_date": "2026-01-01T00:00:00.000Z",
    "pay_day_offset": 3,
    "timezone": "America/Mexico_City",
    "is_active": true,
    "periods_count": 24,
    "created_at": "2026-01-01T00:00:00.000Z",
    "updated_at": "2026-01-01T00:00:00.000Z"
  }
]
}
```

## Consulta calendarios de una razon social [#consulta-calendarios-de-una-razon-social]

***

Se puede buscar un calendario particular por su número, o filtrar por la razón social a la que pertenecen. Ambos filtros hacen coincidencia exacta.

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

| Parametro                 | Tipo    | Requerido | Default | Descripcion                                |
| ------------------------- | ------- | --------- | ------- | ------------------------------------------ |
| `payroll_calendar_number` | integer | No        | -       | Filtra por número de calendario exacto.    |
| `legal_entity_number`     | integer | No        | -       | Filtra por la razón social del calendario. |

**cURL**

```bash
curl -X GET "https://app.integranom.com/api/v1/payroll-calendars?legal_entity_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": [
  {
    "payroll_calendar_number": 3,
    "legal_entity_number": 1,
    "name": "Quincenal 2026",
    "frequency": "semimonthly",
    "isr_tariff_frequency": "semimonthly",
    "applies_seventh_day_discount": true,
    "month_day_factor": 30,
    "anchor_date": "2026-01-01T00:00:00.000Z",
    "pay_day_offset": 3,
    "timezone": "America/Mexico_City",
    "is_active": true,
    "periods_count": 24,
    "created_at": "2026-01-01T00:00:00.000Z",
    "updated_at": "2026-01-01T00:00:00.000Z"
  }
]
}
```

## Errores [#errores]

| Status | Causa                                                                                                      |
| ------ | ---------------------------------------------------------------------------------------------------------- |
| `400`  | Valor inválido en algún filtro (`payroll_calendar_number`, `legal_entity_number`, `frequency` o `active`). |
| `401`  | API key ausente o inválida.                                                                                |