v2

latestOpenAPI 3.0.3CC-BY-4.02026-07-262256119.8 KB
Fiscal

Subvenciones BDNS abiertas por código CNAE

Devuelve 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 respuesta se limita a 5 resultados con campos de descubrimiento (codigo_bdns, titulo, organo, nivel1, cnae_seccion, url_oficial, importe, estado). Con plan Profesional o superior se honran además region, estado, solo_actividad, importe_min, limit (máx. 100) y offset, y la respuesta incluye todos los campos (finalidad, tipos_beneficiarios, regiones, instrumentos, sectores, fecha_apertura, fecha_recepcion, url_bases, abierto). importe es la dotación total de la convocatoria (no por beneficiario). El campo fecha_cierre nunca se expone — el dato de BDNS es poco fiable como plazo y no debe usarse para tomar decisiones de fecha límite. Nota sobre filtros y paginación: region, estado e importe_min se aplican sobre la ventana de filas ya obtenida (hasta offset + limit, con techo de 200), no sobre el conjunto completo de convocatorias del CNAE — una respuesta filtrada puede devolver menos filas que limit, y paginar más allá de esa ventana no garantiza cobertura exhaustiva.

get/subvenciones

Query parameters

cnaestring required
Example:4711

Código CNAE 2025 con o sin puntos (p. ej. 47.11 o 4711).

regionstring
Example:Madrid

Filtra por Comunidad Autónoma (nombre normalizado, p. ej. Madrid). Solo plan Profesional o superior.

estadostring
Example:abierto

Filtra por estado (abierto, cerrado, u otro valor libre comparado contra el campo estado). Solo plan Profesional o superior. Nota: este endpoint solo expone convocatorias ABIERTAS, por lo que filtrar por un estado cerrado (p. ej. cerrado) siempre devuelve un resultado vacío.

solo_actividadboolean

Si es true, limita a convocatorias cuyos beneficiarios encajan con autónomos/pymes (señal tipos_beneficiarios, no es_para_empresas). Solo plan Profesional o superior.

importe_minnumber
Example:100000

Importe (dotación) mínimo de la convocatoria. Solo plan Profesional o superior.

limitinteger

Número máximo de resultados (1–100, por defecto 50). Ignorado en plan Free (fijo en 5). Solo plan Profesional o superior.

offsetinteger

Desplazamiento de paginación. Se aplica sobre una ventana máxima de 200 filas — offsets mayores devuelven una página vacía. Solo plan Profesional o superior.

Response

Subvenciones BDNS aplicables al código CNAE

cnaestring

Código CNAE consultado, tal y como se envió.

totalinteger

Número de filas devueltas en esta página.

Example response

{
  "cnae": "4711",
  "subvenciones": [
    {
      "codigo_bdns": "800123",
      "titulo": "Ayudas a la digitalización de pymes",
      "organo": "Ministerio de Industria",
      "nivel1": "Estado",
      "cnae_seccion": "G",
      "importe": 5000000,
      "estado": "abierto"
    }
  ],
  "total": 3,
  "_meta": {
    "plan": "free",
    "remaining": 248,
    "upgrade_hint": "Has usado más del 80% de tu cuota diaria. Mejora a Profesional por 29€/mes para 2000 consultas/día: https://www.conversoriaecnae.es/precios",
    "upgrade": {
      "url": "https://www.conversoriaecnae.es/precios",
      "current_plan": "free",
      "recommended_plan": {
        "id": "profesional",
        "label": "Profesional",
        "daily_limit": 2000,
        "monthly_price_eur": 29
      },
      "daily_limit_after": 2000,
      "price_eur_monthly": 29
    },
    "count": 3
  }
}