---
title: "Búsqueda de consultas vinculantes de la DGT"
method: GET
path: "/dgt"
tags: ["Fiscal"]
---

# Búsqueda de consultas vinculantes de la DGT

`GET /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`).

## Query parameters

- `q` string, required
- `code` string
- `limit` integer
- `offset` integer

## Response `200`

Consultas de la DGT que coinciden con la búsqueda

- DgtSearchResponse — Resultado de la búsqueda de consultas vinculantes de la DGT. La forma de cada elemento de `consultas` depende del plan — ver DgtDiscoveryItem (Free) y DgtSearchFullItem (Profesional+).
  - `query` string — Texto de búsqueda enviado.
  - `consultas` union[]
    - union
      - DgtDiscoveryItem — Proyección de campos de descubrimiento (plan Free) — máx. 3 filas por respuesta.
        - `titulo_seo` string, nullable
        - `resumen` string, nullable
      - DgtSearchFullItem — Proyección completa (plan Profesional o superior).
        - `numero` string
        - `slug` string
        - `titulo_seo` string, nullable
        - `resumen` string, nullable
        - `fecha` string, nullable
        - `organo` string, nullable
        - `rank` number — Relevancia de la búsqueda de texto completo (mayor es más relevante).
  - `total` integer — Número de filas devueltas en esta página.
  - `_meta` DgtSearchMeta — Metadatos del envelope para endpoints con clave: plan actual, cuota restante y nudge de upgrade (solo plan Free al ≥80% de cuota).
    - `plan` string, required — Plan de la clave (free, profesional, empresa, enterprise).
    - `remaining` integer, required — Peticiones restantes de la cuota diaria.
    - `upgrade_hint` string — Mensaje legible de upgrade. Presente solo en plan Free al consumir ≥80% de la cuota.
    - `upgrade` UpgradeMeta — Forma estructurada del nudge de upgrade para renderizar UI nativa. Presente solo en plan Free al ≥80% de cuota.
      - `hint` string
      - `url` string, uri
      - `current_plan` string
      - `recommended_plan` object
        - `id` string
        - `label` string
        - `daily_limit` integer
        - `monthly_price_eur` integer
      - `daily_limit_after` integer
      - `price_eur_monthly` integer
    - `count` integer
    - `note` string, nullable — Presente solo en plan Free — explica el tope de 3 filas y que el filtro por código y la paginación requieren plan Profesional o superior.
    - `offset` integer, nullable — Presente solo en plan Profesional o superior — el offset efectivamente aplicado.

## Other responses

- `400` — Petición inválida (parámetro o cuerpo mal formado).
- `401` — Falta la cabecera `X-API-Key` o la clave es inválida/desactivada.
- `429` — Límite de cuota diaria o de ráfaga superado. La cabecera `Retry-After` indica los segundos hasta poder reintentar.
- `500` — Error interno del servidor.

---

[API](https://skmtc.dev/conversoriaecnae/apis/conversor-iae-cnae-api.md) · [All operations](https://skmtc.dev/conversoriaecnae/apis/conversor-iae-cnae-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/conversoriaecnae/conversor-iae-cnae-api/revisions/2f9842f5e11b/schema)