API de empresas DATOK
Consulta por CUIT de datos fiscales, BCRA, facturas apócrifas y autoridades. v1.
Autenticación
Todas las llamadas requieren tu API key en el header X-Api-Key. La key te la entregamos al activar tu plan.
X-Api-Key: dk_live_xxxxxxxxxxxxxxxxxxxx
Probar la key
GET/api/v1/health — valida la key y devuelve el cupo restante.
curl https://datok.com.ar/api/v1/health \
-H "X-Api-Key: TU_API_KEY"
{
"ok": true,
"tier": "basic",
"cliente": "Mi Empresa S.A.",
"cupo_mensual": 500,
"consultas_usadas": 12,
"consultas_restantes": 488,
"ciclo_desde": "2026-06-01"
}
Consulta individual
GET/api/v1/empresa/{cuit} — datos consolidados de una empresa.
curl https://datok.com.ar/api/v1/empresa/30500010912 \
-H "X-Api-Key: TU_API_KEY"
{
"cuit": "30500010912",
"encontrada": true,
"empresa": {
"razon_social": "EMPRESA EJEMPLO S.A.",
"tipo_societario": "SA",
"fecha_constitucion": "1998-03-12",
"actividad": { "codigo": "461031", "descripcion": "Venta al por mayor..." },
"domicilio_fiscal": { "calle": "...", "localidad": "...", "provincia": "MENDOZA", "cp": "5500" }
},
"afip": {
"en_padron": true,
"condicion_iva": "Responsable Inscripto",
"ganancias": "Inscripto",
"monotributo": null,
"es_empleador": true
},
"bcra": {
"deuda": {
"tiene_deuda": true,
"peor_situacion": 2,
"monto_total_miles": 1540,
"entidades": [ { "entidad": "BANCO ...", "situacion": 2, "monto_miles": 1540 } ]
},
"cheques_rechazados": { "cantidad": 0, "monto_total": 0, "sin_levantar": 0 }
},
"facturas_apocrifas": { "marcada": false, "registros": [] },
"autoridades": {
"disponible": true,
"directorio": [
{ "nombre": "JUAN PEREZ", "cargo": "PRESIDENTE", "cuit_persona": "20...", "fuente": "...", "fecha": "..." }
]
},
"consultado_en": "2026-06-13T18:00:00Z"
}
Notas sobre los campos
| Campo | Detalle |
|---|---|
bcra.deuda.monto_total_miles | Monto expresado en miles de pesos (criterio BCRA). |
bcra.deuda.peor_situacion | 1 = normal … 5 = irrecuperable. Mayor es peor. |
autoridades.disponible | false si todavía no tenemos directorio confirmado para esa empresa. No es un error. |
encontrada | false si el CUIT no figura en nuestras bases. |
Consulta por lote
POST/api/v1/empresas — hasta 100 CUITs por request.
curl -X POST https://datok.com.ar/api/v1/empresas \
-H "X-Api-Key: TU_API_KEY" \
-H "Content-Type: application/json" \
-d '{"cuits": ["30500010912", "30546741253"]}'
{
"total": 2,
"consultas_facturadas": 2,
"consultas_restantes": 486,
"resultados": [ { "cuit": "...", "encontrada": true, ... }, ... ]
}
Errores
| HTTP | error | Significado |
|---|---|---|
| 401 | missing_api_key / invalid_api_key | Falta el header o la key es inválida/desactivada. |
| 400 | cuit_invalido | El CUIT no tiene 11 dígitos. |
| 429 | cupo_agotado | Consumiste el cupo del ciclo. Escribinos para ampliar. |
Límites
- Máximo recomendado: 5 requests por segundo por key.
- Lote: hasta 100 CUITs por request.
- Cupo mensual según tu plan (se reinicia el día 1 de cada mes).
Cobertura y alcance de la información
Relevamos los boletines oficiales de 20 de las 24 jurisdicciones del país (incluidas CABA/registro nacional, Buenos Aires, Córdoba, Santa Fe y Mendoza). Quedan pendientes de integración Formosa, San Juan, Santiago del Estero y Tierra del Fuego. La información fiscal (AFIP/ARCA) y financiera (BCRA, facturas apócrifas) es de alcance nacional, para la totalidad de los CUITs.
Dudas de integración: [email protected]