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

El cupo de consultas se cuenta por ciclo mensual (desde el día 1). Cada CUIT consultado cuenta como una consulta. Los créditos no consumidos no se acumulan.

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).

Dudas de integración: [email protected]