Conversor IAE CNAE Códigos API

Detalle de códigos IAE, CNAE 2025 y CNAE 2009, y lookup masivo.

GitHub OpenAPI

Operations 4

GET /iae/{code} Detalle de un código IAE #
GET /cnae/{code} Detalle de un código CNAE 2025 #
GET /cnae-2009/{code} Correspondencia CNAE 2009 → CNAE 2025 #
POST /bulk Lookup masivo de códigos #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • 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.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/conversoriaecnae-es:conversoriaecnae-es-c-digos-api"
All apis
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.

Get an API 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 Specification

conversoriaecnae-es-c-digos-api-openapi.yml Raw ↑
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