---
title: "Régimen de módulos de un código IAE"
method: GET
path: "/modulos/{code}"
tags: ["Fiscal"]
---

# Régimen de módulos de un código IAE

`GET /modulos/{code}`

Devuelve el régimen de módulos (estimación objetiva) para un código IAE: módulos IRPF/IVA, umbrales e inteligencia fiscal. Disponible en el plan Free (requiere una clave de API, cualquier plan sirve). Usa `?slug=` para desambiguar códigos que mapean a varias filas (409).

## Path parameters

- `code` string, required

## Query parameters

- `slug` string

## Response `200`

Régimen de módulos del código IAE

- ModulosDetail — Régimen de módulos (estimación objetiva) de un código IAE.
  - `code` string — Código normalizado, sin puntos (este endpoint devuelve la forma normalizada, a diferencia de /iae/{code} que devuelve la forma con puntos).
  - `slug` string
  - `titulo` string, nullable
  - `modulos_eligible` boolean, nullable
  - `regimen` Regimen
    - `actividad` object, nullable
    - `modulos_irpf` object[]
    - `modulos_iva` object[]
    - `umbrales_actividad` object, nullable
    - `umbrales_generales` object, nullable
    - `intelligence` object, nullable
      - `modulos_summary` string, nullable
      - `calculo_hints` object, nullable
        - `primary_modulos` unknown[]
          - unknown
        - `common_pitfalls` unknown[]
          - unknown
      - `citations` unknown[]
        - unknown
  - `citation` object, nullable — Cita de fuente y frescura del régimen de módulos, leída del sidecar `modulos_snapshot` (Orden HAC/1425/2025). `null` cuando no hay snapshot sincronizado para este código — no es un error.
    - `orden` string, nullable
    - `source_anchor` string, nullable
    - `ejercicio` integer, nullable
    - `verified_at` string, date-time, nullable
  - `_meta` Meta — Metadatos del envelope para endpoints con clave: plan actual, cuota restante y nudge de upgrade (solo plan Free al ≥80% de cuota).
    - `plan` string, required — Plan de la clave (free, profesional, empresa, enterprise).
    - `remaining` integer, required — Peticiones restantes de la cuota diaria.
    - `upgrade_hint` string — Mensaje legible de upgrade. Presente solo en plan Free al consumir ≥80% de la cuota.
    - `upgrade` UpgradeMeta — Forma estructurada del nudge de upgrade para renderizar UI nativa. Presente solo en plan Free al ≥80% de cuota.
      - `hint` string
      - `url` string, uri
      - `current_plan` string
      - `recommended_plan` object
        - `id` string
        - `label` string
        - `daily_limit` integer
        - `monthly_price_eur` integer
      - `daily_limit_after` integer
      - `price_eur_monthly` integer

## Other responses

- `400` — Petición inválida (parámetro o cuerpo mal formado).
- `401` — Falta la cabecera `X-API-Key` o la clave es inválida/desactivada.
- `404` — Código no encontrado.
- `409` — El código mapea a varias filas. Usa `?slug=` (de `candidates[].url`) para desambiguar.
- `429` — Límite de cuota diaria o de ráfaga superado. La cabecera `Retry-After` indica los segundos hasta poder reintentar.
- `500` — Error interno del servidor.

---

[API](https://skmtc.dev/conversoriaecnae/apis/conversor-iae-cnae-api.md) · [All operations](https://skmtc.dev/conversoriaecnae/apis/conversor-iae-cnae-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/conversoriaecnae/conversor-iae-cnae-api/revisions/2f9842f5e11b/schema)