v2

latestOpenAPI 3.0.3CC-BY-4.02026-07-262256119.8 KB
Códigos

Lookup masivo de códigos

Consulta hasta 50 códigos IAE o CNAE en una sola petición. Requiere plan Profesional o superior. Devuelve los resultados en el mismo orden que se solicitan, con found: false para los no encontrados.

post/bulk

Request body

codesstring[] required

Lista de códigos (1–50). Cada uno solo dígitos y puntos, máx. 20 caracteres.

type'iae' | 'cnae' required

Example request

{
  "codes": [
    "501.3",
    "504.1",
    "505.4"
  ],
  "type": "iae"
}

Response

Resultados del lookup masivo

type'iae' | 'cnae'
totalinteger
foundinteger

Example response

{
  "type": "iae",
  "results": [
    {
      "code": "501.3",
      "found": true
    }
  ],
  "total": 3,
  "found": 2,
  "_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
    }
  }
}