Conversor IAE CNAE Códigos API
Detalle de códigos IAE, CNAE 2025 y CNAE 2009, y lookup masivo.
Detalle de códigos IAE, CNAE 2025 y CNAE 2009, y lookup masivo.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/conversoriaecnae-es:conversoriaecnae-es-c-digos-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Conversoriaecnae Es Códigos API
version: 1.0.0
contact:
name: Conversor IAE CNAE
email: brian@conversoriaecnae.es
url: https://www.conversoriaecnae.es/precios
license:
name: CC-BY-4.0
url: https://creativecommons.org/licenses/by/4.0/
termsOfService: https://www.conversoriaecnae.es/terminos-condiciones
description: 'Operations tagged Códigos across 2 of this provider''s published API definitions: conversoriaecnae-es-openapi.json, conversoriaecnae-es-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://www.conversoriaecnae.es/api/v1
description: Producción
security:
- ApiKeyAuth: []
tags:
- name: Códigos
description: Detalle de códigos IAE, CNAE 2025 y CNAE 2009, y lookup masivo.
paths:
/iae/{code}:
get:
operationId: getIaeByCode
summary: Detalle de un código IAE
description: 'Devuelve el detalle de un código IAE (epígrafe). El código admite forma con o sin puntos (`501.3` o `5013`). Si un código numérico corresponde a varias filas (p. ej. aparece en secciones Empresarial y Profesional), responde 409 con `candidates[]`; usa `?slug=` para desambiguar. En plan Free, `associated_cnae` es un objeto bloqueado (`locked: true`, `count`, `upgrade_url`) y `related_iae` se omite; el array completo requiere plan Profesional, prueba Profesional activa o superior. En esos planes la respuesta incluye además `cnae_2025_mapping` (`1:1`, `1:n` o `sin_correspondencia`); en plan Free el campo no aparece.'
tags:
- Códigos
security:
- ApiKeyAuth: []
parameters:
- $ref: '#/components/parameters/IaeCodePath'
- $ref: '#/components/parameters/SlugQuery'
responses:
'200':
description: Detalle del código IAE
headers:
X-RateLimit-Limit:
$ref: '#/components/headers/XRateLimitLimit'
X-RateLimit-Remaining:
$ref: '#/components/headers/XRateLimitRemaining'
X-RateLimit-Reset:
$ref: '#/components/headers/XRateLimitReset'
X-Conversor-Plan:
$ref: '#/components/headers/XConversorPlan'
content:
application/json:
schema:
$ref: '#/components/schemas/IaeDetail'
'400':
$ref: '#/components/responses/BadRequest'
'401':
$ref: '#/components/responses/Unauthorized'
'404':
$ref: '#/components/responses/NotFound'
'409':
$ref: '#/components/responses/AmbiguousCode'
'429':
$ref: '#/components/responses/RateLimited'
'500':
$ref: '#/components/responses/ServerError'
servers:
- url: https://www.conversoriaecnae.es/api/v1
description: Producción
/cnae/{code}:
get:
operationId: getCnaeByCode
summary: Detalle de un código CNAE 2025
description: '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); en plan Free, `associated_iae` es un objeto bloqueado (`locked: true`, `count`, `upgrade_url`) y `related_cnae` y `cnae_2009` se omiten; el array completo y esos campos requieren plan Profesional, prueba Profesional activa o superior.'
tags:
- Códigos
security:
- ApiKeyAuth: []
parameters:
- $ref: '#/components/parameters/CnaeCodePath'
responses:
'200':
description: Detalle del código CNAE 2025
headers:
X-RateLimit-Limit:
$ref: '#/components/headers/XRateLimitLimit'
X-RateLimit-Remaining:
$ref: '#/components/headers/XRateLimitRemaining'
X-RateLimit-Reset:
$ref: '#/components/headers/XRateLimitReset'
X-Conversor-Plan:
$ref: '#/components/headers/XConversorPlan'
content:
application/json:
schema:
$ref: '#/components/schemas/CnaeDetail'
'401':
$ref: '#/components/responses/Unauthorized'
'404':
$ref: '#/components/responses/NotFound'
'429':
$ref: '#/components/responses/RateLimited'
'500':
$ref: '#/components/responses/ServerError'
servers:
- url: https://www.conversoriaecnae.es/api/v1
description: Producción
/cnae-2009/{code}:
get:
operationId: getCnae2009Correspondence
summary: Correspondencia CNAE 2009 → CNAE 2025
description: Devuelve las correspondencias de un código CNAE 2009 (obsoleto) hacia CNAE 2025. Requiere plan Profesional o superior. Incluido en la prueba Profesional de 14 días.
tags:
- Códigos
security:
- ApiKeyAuth: []
parameters:
- $ref: '#/components/parameters/Cnae2009CodePath'
responses:
'200':
description: Correspondencias CNAE 2009 → CNAE 2025
content:
application/json:
schema:
$ref: '#/components/schemas/Cnae2009Correspondence'
'400':
$ref: '#/components/responses/BadRequest'
'401':
$ref: '#/components/responses/Unauthorized'
'403':
$ref: '#/components/responses/PaidRequired'
'404':
$ref: '#/components/responses/NotFound'
'429':
$ref: '#/components/responses/RateLimited'
'500':
$ref: '#/components/responses/ServerError'
servers:
- url: https://www.conversoriaecnae.es/api/v1
description: Producción
/bulk:
post:
operationId: bulkLookup
summary: Lookup masivo de códigos
description: 'Consulta hasta 50 códigos IAE o CNAE en una sola petición. Requiere plan Profesional o superior. No incluido en la prueba de 14 días. Devuelve los resultados en el mismo orden que se solicitan, con `found: false` para los no encontrados.'
tags:
- Códigos
security:
- ApiKeyAuth: []
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/BulkRequest'
responses:
'200':
description: Resultados del lookup masivo
content:
application/json:
schema:
$ref: '#/components/schemas/BulkResponse'
'400':
$ref: '#/components/responses/BadRequest'
'401':
$ref: '#/components/responses/Unauthorized'
'403':
$ref: '#/components/responses/PaidRequired'
'429':
$ref: '#/components/responses/RateLimited'
'500':
$ref: '#/components/responses/ServerError'
servers:
- url: https://www.conversoriaecnae.es/api/v1
description: Producción
components:
parameters:
Cnae2009CodePath:
name: code
in: path
required: true
description: Código CNAE 2009 con o sin puntos (máx. 20 caracteres).
schema:
type: string
pattern: ^[\d.]+$
maxLength: 20
example: '4711'
SlugQuery:
name: slug
in: query
required: false
description: Slug para desambiguar cuando un código numérico mapea a varias filas. 1–120 caracteres, `^[a-z0-9-]+$`.
schema:
type: string
minLength: 1
maxLength: 120
pattern: ^[a-z0-9-]+$
example: albanileria
CnaeCodePath:
name: code
in: path
required: true
description: Código CNAE 2025 con o sin puntos (p. ej. `68.20` o `6820`).
schema:
type: string
pattern: ^[\d.]+$
example: '6820'
IaeCodePath:
name: code
in: path
required: true
description: Código IAE con o sin puntos (p. ej. `501.3` o `5013`).
schema:
type: string
pattern: ^[\d.]+$
example: '5013'
schemas:
LockedTeaser:
type: object
description: 'Campo de correspondencia bloqueado en respuestas Free: muestra que existe y cuántos códigos contiene, sin revelar ninguno.'
required:
- locked
- count
- upgrade_url
properties:
locked:
type: boolean
enum:
- true
count:
type: integer
minimum: 0
example: 3
description: Número real de códigos asociados.
upgrade_url:
type: string
format: uri
example: https://www.conversoriaecnae.es/precios
PaidRequiredError:
type: object
required:
- error
properties:
error:
type: string
example: Este endpoint requiere un plan de pago (Profesional o superior).
current_plan:
type: string
example: free
upgrade_url:
type: string
format: uri
example: https://www.conversoriaecnae.es/precios
Error:
type: object
description: Cuerpo de error estándar de endpoints con clave.
required:
- error
properties:
error:
type: string
example: IAE code not found
_meta:
$ref: '#/components/schemas/Meta'
UpgradeMeta:
type: object
description: Forma estructurada del nudge de upgrade para renderizar UI nativa. Presente solo en plan Profesional al ≥80% de cuota (nudge a Empresa).
properties:
hint:
type: string
url:
type: string
format: uri
example: https://www.conversoriaecnae.es/precios
current_plan:
type: string
example: free
recommended_plan:
type: object
properties:
id:
type: string
example: profesional
label:
type: string
example: Profesional
daily_limit:
type: integer
example: 2000
monthly_price_eur:
type: integer
example: 29
daily_limit_after:
type: integer
example: 2000
price_eur_monthly:
type: integer
example: 29
BulkResponse:
type: object
properties:
type:
type: string
enum:
- iae
- cnae
example: iae
results:
type: array
items:
$ref: '#/components/schemas/BulkResult'
total:
type: integer
example: 3
found:
type: integer
example: 2
_meta:
$ref: '#/components/schemas/Meta'
AmbiguousCandidate:
type: object
description: Una de las filas que coinciden con el código ambiguo. Sigue `url` para la consulta desambiguada.
properties:
code:
type: string
example: '834'
description: Código con puntos.
cod_integro:
type:
- string
- 'null'
example: '834'
slug:
type: string
example: servicios-relativos-a-la-propiedad-inmobiliaria
title:
type:
- string
- 'null'
example: Servicios relativos a la propiedad inmobiliaria
url:
type: string
example: /api/v1/iae/834?slug=servicios-relativos-a-la-propiedad-inmobiliaria
IaeDetail:
type: object
description: Detalle de un código IAE.
properties:
code:
type: string
example: '501.3'
description: Código con puntos.
cod_integro:
type:
- string
- 'null'
example: '501.3'
slug:
type: string
example: albanileria-y-pequenos-trabajos-de-construccion
seccion_label:
type:
- string
- 'null'
example: 'Sección Primera: Actividades Empresariales'
title:
type:
- string
- 'null'
example: Albañilería y pequeños trabajos de construcción en general
description:
type:
- string
- 'null'
category:
type:
- string
- 'null'
example: Construcción
level:
type:
- integer
- 'null'
example: 3
modulos_eligible:
type:
- boolean
- 'null'
example: true
associated_cnae:
oneOf:
- type:
- array
- 'null'
items: {}
- $ref: '#/components/schemas/LockedTeaser'
description: 'Códigos CNAE 2025 asociados. Plan Profesional, prueba activa o superior: array de códigos. Plan Free (o prueba caducada): objeto `LockedTeaser` con el número real de códigos y sin códigos ni títulos.'
cnae_2025_mapping:
type: string
enum:
- '1:1'
- 1:n
- sin_correspondencia
example: 1:n
description: 'Clasificación de la correspondencia del epígrafe con CNAE 2025: `1:1` (un solo código), `1:n` (varios) o `sin_correspondencia` (ninguno). Solo plan Profesional, prueba activa o superior; en plan Free la clave no aparece.'
related_iae:
type:
- array
- 'null'
items: {}
description: Códigos IAE relacionados (solo plan Profesional o superior).
keywords:
type:
- array
- 'null'
items: {}
description: Palabras clave del epígrafe.
last_updated:
type:
- string
- 'null'
example: '2026-01-15'
_meta:
$ref: '#/components/schemas/Meta'
Meta:
type: object
description: 'Metadatos del envelope para endpoints con clave: plan actual, cuota restante y días restantes de la prueba (solo plan trial) y nudge de upgrade a Empresa (solo plan Profesional al ≥80% de cuota).'
required:
- plan
- remaining
properties:
plan:
type: string
example: free
description: Plan de la clave (free, trial, profesional, empresa, enterprise). `trial` = prueba Profesional de 14 días sin tarjeta; al terminar, la clave pasa a free.
remaining:
type: integer
example: 248
description: Peticiones restantes de la cuota diaria.
trial_ends_in_days:
type: integer
minimum: 0
example: 9
description: Días completos que quedan de la prueba Profesional (redondeo hacia arriba). Presente solo con plan `trial`.
upgrade_hint:
type: string
description: 'Mensaje legible de upgrade a Empresa. Presente solo en plan Profesional al consumir ≥80% de la cuota. Las claves Free ya no reciben este nudge: ven el campo bloqueado (`locked: true`) en `associated_cnae` / `associated_iae`.'
example: 'Estás usando más del 80% de tu cuota diaria de Profesional. Empresa (79€/mes) amplía a 300.000 consultas/mes: https://www.conversoriaecnae.es/precios.'
upgrade:
$ref: '#/components/schemas/UpgradeMeta'
BulkResult:
type: object
required:
- code
- found
properties:
code:
type: string
example: '501.3'
found:
type: boolean
example: true
data:
type:
- object
- 'null'
additionalProperties: true
description: Fila completa del catálogo cuando `found` es true; ausente cuando es false. Para `type=cnae`, el campo `iae_correspondiente` contiene códigos IAE cualificados por sección (`cod_integro_iae`, p. ej. `"A011"`), no códigos numéricos simples — esto desambigua los epígrafes que comparten número entre secciones A/B/C. Para reutilizar uno en `GET /iae/{code}`, quita la letra de sección inicial (`"A011"` → `"011"`). Para `type=iae`, el campo `relaciones_iae` contiene códigos IAE relacionados cualificados por sección (`cod_integro_iae`, p. ej. `"A011"`), no códigos numéricos simples — el mismo criterio de desambiguación. Para reutilizar uno en `GET /iae/{code}`, quita igualmente la letra de sección inicial (`"A011"` → `"011"`).
RateLimitError:
type: object
required:
- error
properties:
error:
type: string
example: Rate limit exceeded
limit:
type: integer
example: 250
plan:
type: string
example: free
retry_after_seconds:
type: integer
example: 3600
current_plan_label:
type: string
example: Free (250 peticiones/día)
upgrade_url:
type: string
format: uri
example: https://www.conversoriaecnae.es/precios
recommended_plan:
type: object
properties:
id:
type: string
example: profesional
label:
type: string
example: Profesional
daily_limit:
type: integer
example: 2000
monthly_price_eur:
type: integer
example: 29
CnaeDetail:
type: object
description: Detalle de un código CNAE 2025.
properties:
code:
type: string
example: '68.20'
description: Código con puntos.
title:
type:
- string
- 'null'
example: Alquiler de bienes inmobiliarios por cuenta propia
description:
type:
- string
- 'null'
category:
type:
- string
- 'null'
level:
type:
- integer
- 'null'
example: 4
associated_iae:
oneOf:
- type:
- array
- 'null'
items: {}
- $ref: '#/components/schemas/LockedTeaser'
description: 'Códigos IAE asociados. Plan Profesional, prueba activa o superior: array de códigos. Plan Free (o prueba caducada): objeto `LockedTeaser` con el número real de códigos y sin códigos ni títulos.'
related_cnae:
type:
- array
- 'null'
items: {}
description: Códigos CNAE relacionados (solo plan Profesional o superior).
cnae_2009:
type:
- array
- 'null'
items: {}
description: Equivalencias CNAE 2009 (solo plan Profesional o superior).
keywords:
type:
- array
- 'null'
items: {}
description: Palabras clave.
last_updated:
type:
- string
- 'null'
example: '2026-01-15'
nace:
type:
- object
- 'null'
description: '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).'
properties:
code:
type: string
example: '68.20'
description: Código NACE con puntos.
revision:
type: string
enum:
- NACE Rev. 2.1
example: NACE Rev. 2.1
description: Versión de la NACE emparejada con la CNAE 2025.
fuente:
type: string
format: uri
example: https://www.ine.es/daco/daco42/clasificaciones/cnae25/Correspondencias_CNAE25_NACE_Rev_2_1.xlsx
description: Fuente primaria (INE) de la que se generó la correspondencia.
_meta:
$ref: '#/components/schemas/Meta'
BulkRequest:
type: object
required:
- codes
- type
properties:
codes:
type: array
description: Lista de códigos (1–50). Cada uno solo dígitos y puntos, máx. 20 caracteres.
minItems: 1
maxItems: 50
items:
type: string
pattern: ^[\d.]+$
maxLength: 20
example:
- '501.3'
- '504.1'
- '505.4'
type:
type: string
enum:
- iae
- cnae
example: iae
Cnae2009Correspondence:
type: object
description: Correspondencias CNAE 2009 → CNAE 2025.
properties:
cnae_2009:
type: string
example: '4711'
description: Código CNAE 2009 normalizado (sin puntos).
correspondences:
type: array
description: Filas de correspondencia hacia CNAE 2025.
items:
type: object
additionalProperties: true
_meta:
$ref: '#/components/schemas/Meta'
AmbiguousCodeError:
type: object
required:
- error
- code
- candidates
properties:
error:
type: string
example: ambiguous_code
code:
type: string
example: '834'
message:
type: string
example: Multiple IAE rows match this code. Use ?slug= to disambiguate.
candidates:
type: array
items:
$ref: '#/components/schemas/AmbiguousCandidate'
_meta:
$ref: '#/components/schemas/Meta'
headers:
XRateLimitRemaining:
description: Peticiones restantes de la cuota diaria tras esta petición.
schema:
type: integer
example: 249
XRateLimitReset:
description: 'Segundos (delta-seconds) hasta que se reinicia la cuota: medianoche Europe/Madrid.'
schema:
type: integer
example: 40000
XConversorPlan:
description: Plan de la clave que ha servido la petición (free, trial, profesional, empresa, enterprise).
schema:
type: string
example: free
XRateLimitLimit:
description: Cuota diaria total de la clave (draft-ietf-httpapi-ratelimit-headers).
schema:
type: integer
example: 250
responses:
PaidRequired:
description: El endpoint requiere un plan de pago (Profesional o superior).
content:
application/json:
schema:
$ref: '#/components/schemas/PaidRequiredError'
example:
error: Este endpoint requiere un plan de pago (Profesional o superior).
current_plan: free
upgrade_url: https://www.conversoriaecnae.es/precios
Unauthorized:
description: Falta la cabecera `X-API-Key` o la clave es inválida/desactivada.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error: Missing X-API-Key header
BadRequest:
description: Petición inválida (parámetro o cuerpo mal formado).
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error: Invalid slug format
_meta:
plan: free
remaining: 248
RateLimited:
description: Límite de cuota diaria o de ráfaga superado. La cabecera `Retry-After` indica los segundos hasta poder reintentar. El 429 por cuota diaria incluye además `X-RateLimit-Limit`, `X-RateLimit-Remaining` (0), `X-RateLimit-Reset` y `X-Conversor-Plan`.
headers:
Retry-After:
description: 'Segundos hasta el siguiente reintento permitido (ráfaga: 1–12 s hasta el siguiente token, según plan; cuota diaria: hasta medianoche Europe/Madrid).'
schema:
type: integer
example: 3600
content:
application/json:
schema:
$ref: '#/components/schemas/RateLimitError'
ServerError:
description: Error interno del servidor.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error: Internal error
NotFound:
description: Código no encontrado.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error: IAE code not found
_meta:
plan: free
remaining: 247
AmbiguousCode:
description: El código mapea a varias filas. Usa `?slug=` (de `candidates[].url`) para desambiguar.
content:
application/json:
schema:
$ref: '#/components/schemas/AmbiguousCodeError'
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: X-API-Key
description: Clave de API con prefijo `cvr_`. Obtén una gratis en POST /signup.
x-refined-from:
- conversoriaecnae-es-openapi.json
- conversoriaecnae-es-openapi.yml