Conversoriaecnae

Conversor IAE/CNAE API

API REST para convertir y consultar códigos fiscales españoles IAE ↔ CNAE 2025, correspondencias CNAE 2009, régimen de módulos (estimación objetiva),…

Government & public#government

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

API REST para convertir y consultar códigos fiscales españoles IAE ↔ CNAE 2025, correspondencias CNAE 2009, régimen de módulos (estimación objetiva), obligaciones fiscales (modelos AEAT) y calendario de plazos. La primera clave de cada email empieza con 14 días de prueba Profesional (2.000 peticiones/día, sin tarjeta); después pasa al plan Gratis (250 peticiones/día).

EN: REST API to convert and look up Spanish tax activity codes (IAE ↔ CNAE 2025), CNAE 2009 correspondences, módulos regime, fiscal obligations (AEAT modelos) and the fiscal deadline calendar. Each email's first key starts with a 14-day Profesional trial (2,000 requests/day, no card), then moves to the Free plan (250 requests/day).

Autenticación

Los endpoints con clave requieren la cabecera X-API-Key: cvr_…. Obtén una clave gratuita (sin tarjeta) en POST /signup o en https://www.conversoriaecnae.es/precios.

Planes y cuotas

  • Free: 250 peticiones/día (sin tarjeta)
  • Profesional: 29€/mes — 2.000 peticiones/día
  • Empresa: 79€/mes — 10.000 peticiones/día
  • Compliance (Enterprise): 199€/mes — 30.000 peticiones/día (900.000/mes)

Límite de ráfaga según plan: 10 (Free/Desarrollador), 30 (Profesional) y 100 (Empresa/Compliance) peticiones/minuto por clave. La cuota diaria se reinicia a las 00:00 (Europe/Madrid). Las respuestas 429 incluyen la cabecera Retry-After (segundos).

Los endpoints cnae-2009, bulk y tarifa-at-ep requieren plan Profesional o superior (403 en plan Free). Los endpoints kyb/enrich y onboarding/activity requieren plan Empresa o superior (403 en Free y Profesional). Los endpoints modulos y obligaciones están disponibles en el plan Free (requieren clave, pero cualquier plan sirve). Los endpoints calendario, dias-habiles, utils/nif-info, signup y subscribe son públicos.

Nota: el plan gratuito (valor interno free, mostrado como "Free" en las respuestas de la API) se comercializa públicamente como "Desarrollador" en las páginas de precios.

Endpoints 23

Códigos

  • GETDetalle de un código IAE/iae/:codeDevuelve 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.…
  • GETDetalle de un código CNAE 2025/cnae/:codeDevuelve 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…
  • GETCorrespondencia CNAE 2009 → CNAE 2025/cnae-2009/:codeDevuelve las correspondencias de un código CNAE 2009 (obsoleto) hacia CNAE 2025. Requiere plan Profesional o superior. Incluido en la prueba Profesional de 14…
  • POSTLookup masivo de códigos/bulkConsulta 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…

Búsqueda

  • GETBuscar códigos IAE/CNAE/search?q=albañileríaBúsqueda híbrida sobre los catálogos IAE y/o CNAE 2025. El parámetro q requiere al menos 2 caracteres.

Fiscal

  • GETRégimen de módulos de un código IAE/modulos/:codeDevuelve 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…
  • GETTarifa AT/EP (cotización por cuenta ajena) de un código CNAE/tarifa-at-ep/:codeDevuelve el tipo de cotización AT/EP (Accidentes de Trabajo / Enfermedades Profesionales, D.A. 61ª TRLGSS, Cuadro I) aplicable a un código CNAE 2025. Esta…
  • GETObligaciones fiscales de un código/obligaciones/:code_type/:codeDevuelve las obligaciones fiscales (modelos AEAT) aplicables a un código IAE o CNAE. Disponible en el plan Free (requiere una clave de API, cualquier plan…
  • GETCalendario fiscal (iCalendar)/calendario/:code_type/:codeDevuelve un archivo iCalendar (RFC 5545, text/calendar) con los plazos AEAT aplicables al código, para suscripción en cualquier app de calendario. Endpoint…
  • GETConsultar si una fecha es día hábil/dias-habilesDevuelve si una fecha es día hábil bajo el calendario estatal de días inhábiles (sábados, domingos y festivos nacionales; art. 30 Ley 39/2015) y, si no lo es,…
  • GETValidar el dígito/letra de control de un NIF/DNI/NIE/CIF/utils/nif-info/:nifValida el carácter de control de un NIF/DNI/NIE/CIF español mediante el algoritmo oficial (Orden EHA/451/2008, Anexo I; RD 1065/2007, arts. 18-24). Endpoint…
  • GETSubvenciones BDNS abiertas por código CNAE/subvenciones?cnae=4711Devuelve convocatorias de subvenciones (BDNS) aplicables a un código CNAE 2025. El parámetro cnae es obligatorio. Con clave gratuita solo se honra cnae: la…
  • GETBúsqueda de texto legislativo BOE consolidado/legislacion?q=alta autónomo actividad económicaBúsqueda de texto completo (FTS en español) sobre el corpus de artículos vigentes del BOE consolidado que alimenta las páginas públicas /legislacion. El…
  • GETArtículo consolidado del BOE (y grafo de hechos en Profesional+)/legislacion/:boe_idDevuelve el texto vigente de un artículo del BOE consolidado (boe_id en la ruta, p. ej. BOE-A-2006-20764; articulo como query, p. ej. 31). articulo es…
  • GETFirmografía de empresas constituidas por código CNAE (BORME)/empresas/:cnaeDevuelve estadísticas de constitución de empresas (BORME) para un código CNAE 2025: recuento total, capital medio/mediano, tendencia mensual y provincias —…
  • GETBúsqueda de consultas vinculantes de la DGT/dgt?q=arrendamiento de inmueblesBúsqueda de texto completo sobre consultas vinculantes y generales de la Dirección General de Tributos (dgt_consultas). El parámetro q es obligatorio. Con…
  • GETDetalle de una consulta vinculante de la DGT/dgt/:slugDevuelve el detalle de una consulta de la DGT identificada por su slug (no el numero, p. ej. V1234-23, que no es válido en una URL). Con clave gratuita se…

Cuenta

  • POSTCrear una API key gratuita/signupCrea una API key y la envía por email. La primera clave de cada email empieza con 14 días de prueba Profesional (2.000 peticiones/día, sin tarjeta); después…
  • POSTSuscribirse a un plan de pago/subscribeCrea una sesión de Stripe Checkout para un plan de pago (Profesional o Empresa) y devuelve la URL de pago. Endpoint público con límite por IP.
  • GETConsultar uso de la API key/usageDevuelve el uso actual de la clave (consumo del día, límite, plan, endpoints más usados). No consume cuota diaria. Requiere la cabecera X-API-Key. Tiene…
  • POSTRotar o revocar tu propia API key/keysPermite al titular de una clave rotarla (genera una clave nueva; la anterior deja de funcionar de inmediato) o revocarla (desactivación inmediata) sin pasar…

B2B

  • POSTEnriquecer actividad económica para KYB bancario/kyb/enrichVista KYB (Know Your Business) para entidades financieras. Devuelve la clasificación IAE/CNAE del cliente, perfil fiscal completo (sector de riesgo, regímenes…
  • POSTConfigurar actividad para onboarding SaaS / facturación/onboarding/activityVista de onboarding para SaaS de facturación y ERPs. Dado un código IAE/CNAE o texto de actividad libre, devuelve toda la configuración fiscal necesaria para…

API details

Base URL
https://www.conversoriaecnae.es/api/v1
Authentication
An API key in the X-API-Key header
Operations
23 operations on 23 pathsGET 17POST 6
Main resources
Fiscal 12Cuenta 4Códigos 4B2B 2Búsqueda 1
Response formats
application/json text/plain text/calendar
Description format
OpenAPI 3.0.3, API version 1.0.0

How to test the Conversor IAE/CNAE API in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the Conversor IAE/CNAE API collection, without the publisher's secrets.
  3. Add your credentialsThis API uses an API key in the X-API-Key header. Add yours in the collection's variables or an environment; the requests already reference it.
  4. Send a requestPick an endpoint, for example “Detalle de un código IAE” (GET /iae/:code), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the Conversor IAE/CNAE API?

API REST para convertir y consultar códigos fiscales españoles IAE ↔ CNAE 2025, correspondencias CNAE 2009, régimen de módulos (estimación objetiva),… It is listed under Government & public and has 23 endpoints.

Who publishes the Conversor IAE/CNAE API?

It is listed from Conversoriaecnae's public API description (an OpenAPI document), not published by Conversoriaecnae on Swastik Codes. Anyone who controls conversoriaecnae.es can claim the profile by adding a DNS TXT record.

What is the base URL of the Conversor IAE/CNAE API?

Requests go to https://www.conversoriaecnae.es/api/v1. Endpoint paths are added to this base URL.

How do I authenticate with the Conversor IAE/CNAE API?

With an API key in the X-API-Key header.

How many endpoints does the Conversor IAE/CNAE API have?

23 operations on 23 paths (17 GET, 6 POST). The largest groups are Fiscal, Cuenta, Códigos, B2B.

Is forking the Conversor IAE/CNAE API free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.