Escribe el NIF o la denominación de una empresa y comprueba si figura en el listado de deudores a la Hacienda Pública que publica la AEAT: el importe, la fecha de referencia y el enlace al listado oficial. Solo empresas, nunca personas. Es una foto a una fecha, no la deuda de hoy.
NIF o denominación de la empresa
# 1. NIF -> company id curl "https://api.prometiam.com/functions/v1/risk-api/companies/search?country=ES&nif=B12345674" \ -H "Authorization: Bearer YOUR_API_KEY" # 2. the company's risk marks curl "https://api.prometiam.com/functions/v1/risk-api/companies/COMPANY_ID?country=ES&include=risk_flags" \ -H "Authorization: Bearer YOUR_API_KEY"
Cada comprobación hace dos consultas con una clave de demostración compartida y de solo lectura: una para encontrar la empresa y otra para leer su marca, con un número limitado por página y por minuto. Con tu propia clave son 2 créditos por empresa.
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. Es lo que en el buscador se conoce como la «lista de morosos de Hacienda». Recoge los saldos a 31 de diciembre del año anterior y se publica unos seis meses después, una vez al año.
Esta página cruza el listado con las empresas por su NIF y te dice si la empresa que buscas tiene una marca, con el importe, la fecha de referencia y el enlace al listado oficial. Es solo de España y solo de empresas.
Primero la página encuentra la empresa en el registro (denominación, NIF, forma jurídica y localidad): comprueba que es la que buscas. Después lee su marca. El ejemplo es ilustrativo: la empresa y los valores están inventados.
| Campo | Ejemplo (inventado) | Qué te dice |
|---|---|---|
| Importe | 1.250.000,00 € | El importe que publica el listado para esa entrada. No es la deuda de hoy. |
| Fecha de referencia | 31 dic 2025 | La fecha a la que se refieren los saldos del listado. |
| Publicado | 30 jun 2026 | Cuándo se publicó el listado. |
| Identificador | Leído directamente del listado | Cómo se leyó el NIF de esa fila: directamente, o reconstruido y contrastado con el nombre de la empresa. |
| Listado oficial | abrir | El enlace al listado de la AEAT, para verificar en la fuente antes de actuar. |
Si la empresa no tiene marca, la página lo dice así: «Sin marca en el listado». Es la ausencia de una marca, no un certificado de que la empresa esté al corriente.
Esta página no consulta la deuda actual: responde a si la empresa figura en un listado publicado. Para saber cómo está hoy con la Agencia Tributaria, lo habitual es pedir a la propia empresa su certificado de estar al corriente de las obligaciones tributarias. Antes de decidir un crédito, un contrato o un pago, combina esta consulta con otras: cómo consultar el Registro Mercantil y el estado de la empresa en buscar una empresa por su CIF o NIF.
Esta página comprueba una empresa por vez. Para revisar una cartera de clientes o proveedores, usa la API: busca la empresa por NIF (1 crédito) y lee su ficha con include=risk_flags (1 crédito). La marca tax_debt trae el importe, la fecha de referencia, la fecha de publicación, cómo se leyó el identificador y el enlace al listado oficial; con risk_flag_type=tax_debt también puedes listar todas las empresas con marca. Un error no cuesta nada.
# 1. NIF -> id de la empresa curl 'https://api.prometiam.com/functions/v1/risk-api/companies/search?country=ES&nif=B12345674' \ -H 'Authorization: Bearer rk_live_...' # 2. las marcas de riesgo de esa empresa curl 'https://api.prometiam.com/functions/v1/risk-api/companies/ID_DE_LA_EMPRESA?country=ES&include=risk_flags' \ -H 'Authorization: Bearer rk_live_...'
La respuesta completa, el código y los campos de la marca están en lista de morosos de Hacienda por API; la versión en inglés es Spain tax debtors API.
Empieza tu prueba gratuita de 14 días · Documentación de la API
La prueba dura 14 días e incluye 500 créditos. Se pide una tarjeta, pero no se cobra nada durante la prueba; después sigue el plan Starter (9,99 € al mes) salvo que la canceles.