# Listar (/docs/developers/api-reference/platform-catalogs/list)

## Descripcion general [#descripcion-general]

Este endpoint devuelve el registro completo de catálogos de plataforma disponibles para tu organización. Los catálogos de plataforma son tablas de parámetros fiscales que la plataforma mantiene (UMA, tarifa ISR, cuotas IMSS, INFONAVIT, ISN por estado, etc.). No se crean ni se borran: solo se consultan (`GET`) y, si lo necesitas, se autoadministran con un override de la organización (`PATCH`). El conjunto de catálogos es fijo, por lo que la respuesta **no se pagina**: devuelve todas las filas de una sola vez.

## Endpoint [#endpoint]

`GET https://app.integranom.com/api/v1/platform-catalogs`

## Consulta el registro de catálogos [#consulta-el-registro-de-catálogos]

***

La respuesta trae `count` con el número total de catálogos y `results` con una fila por cada catálogo. Como el conjunto es fijo, **no hay paginación** ni parámetros de consulta: se devuelve el registro completo.

## Campos de cada fila [#campos-de-cada-fila]

| Campo              | Tipo                                             | Descripcion                                                                                                                                                                                                                                                      |
| ------------------ | ------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `key`              | string                                           | Identificador del catálogo. Es el valor que usas en la URL de los endpoints de detalle y edición.                                                                                                                                                                |
| `name`             | string                                           | Nombre legible del catálogo.                                                                                                                                                                                                                                     |
| `description`      | string                                           | Descripción del catálogo.                                                                                                                                                                                                                                        |
| `shape`            | `"scalar"` \| `"range_table"` \| `"keyed_table"` | Forma del valor del catálogo. Determina la estructura del `payload` al leerlo o editarlo.                                                                                                                                                                        |
| `unit`             | string                                           | Unidad del valor (por ejemplo `MXN`).                                                                                                                                                                                                                            |
| `group_key`        | string                                           | Clave del grupo al que pertenece el catálogo.                                                                                                                                                                                                                    |
| `group_label`      | string                                           | Etiqueta legible del grupo.                                                                                                                                                                                                                                      |
| `frequency_scoped` | boolean                                          | `true` si el catálogo requiere una `frequency` al leerlo o editarlo (por ejemplo la tarifa ISR).                                                                                                                                                                 |
| `is_federal`       | boolean                                          | `true` si es una tabla federal.                                                                                                                                                                                                                                  |
| `regulatory`       | `"legal"` \| `"platform_default"`                | Naturaleza regulatoria del catálogo.                                                                                                                                                                                                                             |
| `source`           | `"org"` \| `"platform"`                          | `"org"` si tu organización lo autoadministra con un override activo; `"platform"` si usa el valor de la plataforma.                                                                                                                                              |
| `is_stale`         | boolean                                          | `true` cuando tienes un override pero la plataforma publicó después una versión más reciente — tu valor autoadministrado quedó rezagado. Consulta el [detalle](/docs/developers/api-reference/platform-catalogs/detail) para comparar contra `platform_payload`. |

**cURL**

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

**Respuesta**

```json
{
"count": 12,
"results": [
  {
    "key": "uma",
    "name": "UMA",
    "description": "Unidad de Medida y Actualización (diaria, mensual, anual).",
    "shape": "scalar",
    "unit": "MXN",
    "group_key": "parametros_generales",
    "group_label": "Parámetros generales",
    "frequency_scoped": false,
    "is_federal": false,
    "regulatory": "legal",
    "source": "platform",
    "is_stale": false
  },
  {
    "key": "isr_tariff",
    "name": "Tarifa ISR",
    "description": "Tarifa del ISR por periodicidad (Art. 96 LISR).",
    "shape": "range_table",
    "unit": "MXN",
    "group_key": "isr",
    "group_label": "ISR e impuesto sobre nómina",
    "frequency_scoped": true,
    "is_federal": true,
    "regulatory": "legal",
    "source": "org",
    "is_stale": true
  }
]
}
```

## Errores [#errores]

| Status | Causa                       |
| ------ | --------------------------- |
| `401`  | API key ausente o inválida. |