---
title: "Detalle de una consulta vinculante de la DGT"
method: GET
path: "/dgt/{slug}"
tags: ["Fiscal"]
---

# Detalle de una consulta vinculante de la DGT

`GET /dgt/{slug}`

Devuelve 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 devuelve identidad y resumen (`titulo_seo`, `resumen`, `normativa`); el texto íntegro (`hechos`, `cuestion`, `contestacion`) se omite por completo. Con plan Profesional o superior se devuelve además el texto íntegro de la consulta, `normas_citadas` y `codes_iae`.

## Path parameters

- `slug` string, required

## Response `200`

Detalle de la consulta DGT

- DgtDetailResponse — Detalle de una consulta DGT. Con plan Free solo se devuelven los campos de DgtDetailFreeItem (identidad + resumen); con plan Profesional o superior se añade el texto íntegro (hechos, cuestión y contestación vinculante).
  - `numero` string
  - `slug` string
  - `tipo` 'vinculante' | 'general'
  - `fecha` string, nullable
  - `organo` string, nullable
  - `titulo_seo` string, nullable
  - `resumen` string, nullable
  - `normativa` string, nullable
  - `hechos` string, nullable — Solo plan Profesional o superior. Antecedentes de hecho planteados en la consulta.
  - `cuestion` string, nullable — Solo plan Profesional o superior. Cuestión planteada a la DGT.
  - `contestacion` string — Solo plan Profesional o superior. Contestación íntegra de la DGT — la conclusión vinculante se sitúa al FINAL del texto, no al principio.
  - `normas_citadas` string[] — Solo plan Profesional o superior. Normas citadas en la contestación.
  - `codes_iae` string[] — Solo plan Profesional o superior. Epígrafes IAE relacionados con la consulta.
  - `_meta` DgtDetailMeta — 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
    - `note` string, nullable — Presente solo en plan Free — explica que el texto íntegro requiere plan Profesional o superior.

## 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.
- `404` — Código no encontrado.
- `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)