v2

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

Búsqueda de consultas vinculantes de la DGT

Bú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 clave gratuita solo se honra q: la respuesta se limita a 3 resultados con campos de descubrimiento (titulo_seo, resumen), sin filtro por código ni paginación. Con plan Profesional o superior se honran además code (filtra por código IAE asociado), limit (máx. 100, por defecto 20) y offset, y la respuesta incluye todos los campos (numero, slug, titulo_seo, resumen, fecha, organo, rank).

get/dgt

Query parameters

qstring required
Example:arrendamiento de inmuebles

Texto de búsqueda libre sobre las consultas de la DGT.

codestring
Example:501.3

Filtra por código IAE asociado. Debe ir con puntos (p. ej. 501.3) — el filtro compara contra los códigos IAE almacenados en formato con puntos; un código sin puntos no devuelve resultados. Solo plan Profesional o superior.

limitinteger

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

offsetinteger

Desplazamiento de paginación (paginación nativa de la RPC subyacente). Solo plan Profesional o superior.

Response

Consultas de la DGT que coinciden con la búsqueda

querystring

Texto de búsqueda enviado.

totalinteger

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

Example response

{
  "query": "arrendamiento de inmuebles",
  "consultas": [
    {
      "titulo_seo": "Tributación del arrendamiento de inmuebles por autónomos",
      "resumen": "La DGT concluye que el arrendamiento de inmuebles tributa por el epígrafe 861 del IAE cuando..."
    }
  ],
  "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
  }
}