---
title: "Detalle de un código CNAE 2025"
method: GET
path: "/cnae/{code}"
tags: ["Códigos"]
---

# Detalle de un código CNAE 2025

`GET /cnae/{code}`

Devuelve el detalle de un código CNAE 2025 con su equivalencia europea NACE Rev. 2.1, sus epígrafes IAE asociados y equivalencias CNAE 2009. El código admite forma con o sin puntos (`68.20` o `6820`). El campo `nace` está incluido en todos los planes (también en el gratuito); los campos `associated_iae`, `related_cnae` y `cnae_2009` requieren plan Profesional o superior.

## Path parameters

- `code` string, required

## Response `200`

Detalle del código CNAE 2025

- CnaeDetail — Detalle de un código CNAE 2025.
  - `code` string — Código con puntos.
  - `title` string, nullable
  - `description` string, nullable
  - `category` string, nullable
  - `level` integer, nullable
  - `associated_iae` unknown[], nullable — Códigos IAE asociados (solo plan Profesional o superior).
    - unknown
  - `related_cnae` unknown[], nullable — Códigos CNAE relacionados (solo plan Profesional o superior).
    - unknown
  - `cnae_2009` unknown[], nullable — Equivalencias CNAE 2009 (solo plan Profesional o superior).
    - unknown
  - `keywords` unknown[], nullable — Palabras clave.
    - unknown
  - `last_updated` string, nullable
  - `nace` object, nullable — Equivalencia europea NACE Rev. 2.1 del código CNAE 2025, según la tabla oficial de correspondencias del INE. Disponible en todos los planes, incluido el gratuito. `null` si el código no tiene equivalencia. Atención: la mayoría son equivalencias 1:1, pero España subdivide algunas clases europeas (p. ej. CNAE 41.01 y 41.02 corresponden ambas a NACE 41.00).
    - `code` string — Código NACE con puntos.
    - `revision` 'NACE Rev. 2.1' — Versión de la NACE emparejada con la CNAE 2025.
    - `fuente` string, uri — Fuente primaria (INE) de la que se generó la correspondencia.
  - `_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

- `401` — Falta la cabecera `X-API-Key` o la clave es inválida/desactivada.
- `404` — Código no encontrado.
- `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.

## Changes

- **2026-08-24** `711fcb628273` — 1 info
  - added the optional property `nace` to the response with the `200` status

[Change history](https://skmtc.dev/conversoriaecnae/apis/conversor-iae-cnae-api/changes/cnae/:code/get.md)

---

[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)