¿Qué es la lista de morosos de Hacienda?

Es el listado de deudores a la Hacienda Pública que publica la Agencia Tributaria (AEAT) conforme al artículo 95 bis de la Ley General Tributaria, con deudas superiores a 600.000 euros. Prometiam lo cruza con las fichas de empresa por NIF y sirve cada coincidencia como una marca de riesgo tax_debt.

¿Puedo consultar por API si una empresa debe a Hacienda hoy?

No. La API responde si la empresa figura en el listado publicado, que recoge los saldos a 31 de diciembre del año anterior y se publica unos seis meses después. No es un saldo actual. Para la situación de hoy, pida a la empresa su certificado de estar al corriente de las obligaciones tributarias.

¿Que no haya marca significa que la empresa no debe nada?

No. Solo figuran deudas superiores a 600.000 euros, el listado es anual y el cruce es por NIF exacto sobre identificadores leídos de un PDF escaneado, a costa de la exhaustividad para proteger la precisión. Algunas empresas del listado no llevan marca. La ausencia de marca no es información.

¿Cómo sé cómo se identificó a una empresa?

Cada marca trae identifier_source: direct_read si el identificador se leyó directamente de la fuente, name_corroborated si se reconstruyó y se contrastó con el nombre de la empresa, con name_match_score. Puede filtrar por él si solo quiere entradas leídas directamente.

¿Cubre personas físicas u otros países?

No. La marca tax_debt es solo de España y se sirve sobre fichas de empresa; las personas físicas del listado no se sirven. El listado es anual.

¿Cómo listo todas las empresas que llevan la marca?

Llame a GET /companies/search con country=ES y risk_flag_type=tax_debt (o has_risk_flag=true). No hace falta nombre. Pagine con next_cursor y lea cada marca con include=risk_flags sobre la empresa.

Lista de morosos de Hacienda por API: consulta si una empresa figura en el listado de deudores de la AEAT

La Agencia Tributaria (AEAT) publica, conforme al artículo 95 bis de la Ley General Tributaria, el listado de deudores a la Hacienda Pública con deudas superiores a 600.000 euros. La API cruza ese listado con las fichas de empresa por NIF y devuelve cada coincidencia como una marca de riesgo tax_debt, con el importe, la fecha de referencia y el enlace a la fuente oficial. Es una foto a una fecha, no un saldo actual, y cada marca indica cómo se leyó su identificador.

Consultar si una empresa debe a Hacienda: qué responde y qué no

La API responde si la empresa figura en el listado publicado. No consulta la deuda de hoy: para eso, pida a la empresa su certificado de estar al corriente de las obligaciones tributarias de la AEAT.

Lea esto antes de fiarse de una coincidencia

Dato a una fecha, no saldo actual: el listado recoge los saldos a 31 de diciembre del año anterior y se publica unos seis meses después. Se actualiza una vez al año.
La inclusión es recurrible y la situación de la empresa puede haber cambiado desde la fecha de referencia. Verifique en source_url antes de actuar.
Solo figuran deudas superiores a 600.000 euros. Que no haya marca nunca significa que la empresa no deba nada.
La fuente es un PDF escaneado, así que los identificadores se leen por OCR. Todos se validan con su dígito de control y se cruzan por NIF exacto, nunca por nombre, a costa de la exhaustividad para proteger la precisión: algunas empresas del listado no llevan marca.
Cada marca indica si su identificador se leyó directamente (identifier_source direct_read) o se reconstruyó con corroboración por nombre (name_corroborated, con name_match_score).
Solo se sirven entradas que corresponden a una ficha de empresa; las personas físicas del listado no.

Dos llamadas

Comprobar una empresa: GET /companies/search?nif=NIF&country=ES devuelve el id y GET /companies/{id}?country=ES&include=risk_flags devuelve risk_flags con amount_eur, severity, reference_date, published_date, source_url, identifier_source e is_point_in_time. Listar todas las empresas con marca: GET /companies/search?country=ES&risk_flag_type=tax_debt (o has_risk_flag=true, solo España), paginado con next_cursor.

Qué no es

No es la situación actual de la empresa con la AEAT, no es una puntuación de crédito y no es una comprobación de insolvencia: los avisos de insolvencia de empresas son un endpoint aparte, en nueve mercados (FR, DE, GB, AT, CH, NO, FI, US, NL), y el concurso de acreedores español está en /search.

Precio

Gratis: prueba de 14 días, 1.000 llamadas al mes, sin tarjeta. Después Starter a 9,99 €/mes (10.000 llamadas), Professional a 29,99 €/mes y Scale a 99,99 €/mes. Consulte los precios y la documentación de la ficha de empresa.

Leer la guía completa · English version · Verificar el NIF de una empresa · Conseguir una clave gratuita

Comprobar una empresa por NIF

Campo	Qué contiene
`flag_type`	`tax_debt` para este listado. En una empresa española el array también puede traer la entrada `registry_compliance`, así que elija la marca por tipo y no por posición.
`amount_eur`	El importe que publica el listado, en euros.
`reference_date`, `as_of`	La fecha a la que se refieren los saldos del listado. `as_of` la repite.
`published_date`	Cuándo se publicó el listado.
`source_url`	La fuente oficial, para que verifique en ella.
`identifier_source`, `name_match_score`	Cómo se leyó el identificador: `direct_read`, o `name_corroborated` con una puntuación de coincidencia de nombre.
`is_point_in_time`, `note`	Siempre `true`, y una advertencia en claro de que es una foto a una fecha.

Frequently asked questions

¿Qué es la lista de morosos de Hacienda?: Es el listado de deudores a la Hacienda Pública que publica la Agencia Tributaria (AEAT) conforme al artículo 95 bis de la Ley General Tributaria, con deudas superiores a 600.000 euros. Prometiam lo cruza con las fichas de empresa por NIF y sirve cada coincidencia como una marca de riesgo tax_debt.
¿Puedo consultar por API si una empresa debe a Hacienda hoy?: No. La API responde si la empresa figura en el listado publicado, que recoge los saldos a 31 de diciembre del año anterior y se publica unos seis meses después. No es un saldo actual. Para la situación de hoy, pida a la empresa su certificado de estar al corriente de las obligaciones tributarias.
¿Que no haya marca significa que la empresa no debe nada?: No. Solo figuran deudas superiores a 600.000 euros, el listado es anual y el cruce es por NIF exacto sobre identificadores leídos de un PDF escaneado, a costa de la exhaustividad para proteger la precisión. Algunas empresas del listado no llevan marca. La ausencia de marca no es información.
¿Cómo sé cómo se identificó a una empresa?: Cada marca trae identifier_source: direct_read si el identificador se leyó directamente de la fuente, name_corroborated si se reconstruyó y se contrastó con el nombre de la empresa, con name_match_score. Puede filtrar por él si solo quiere entradas leídas directamente.
¿Cubre personas físicas u otros países?: No. La marca tax_debt es solo de España y se sirve sobre fichas de empresa; las personas físicas del listado no se sirven. El listado es anual.
¿Cómo listo todas las empresas que llevan la marca?: Llame a GET /companies/search con country=ES y risk_flag_type=tax_debt (o has_risk_flag=true). No hace falta nombre. Pagine con next_cursor y lea cada marca con include=risk_flags sobre la empresa.