Informes

Consultar informe crediticio

Obtené el informe crediticio completo de una persona: score, historial BCRA, empleo, situación impositiva, domicilios, teléfonos y más.

POST/api/v1/credit/lookup—Consulta un informe crediticio por CUIL o DNI+sexo

Necesitás una API key de producto Informes. Una key de CBU devuelve 403 FORBIDDEN.

Body — Opción A: por CUIL

Parámetro	Tipo	Obligatorio	Descripción
`cuil`	string	Sí	CUIL de 11 dígitos numéricos (sin guiones)

Body

{ "cuil": "27301234567" }

Body — Opción B: por DNI + Sexo

Parámetro	Tipo	Obligatorio	Descripción
`dni`	string	Sí	DNI de 7 u 8 dígitos numéricos
`sexo`	"M" \| "F"	Sí	Sexo registral

Body

{ "dni": "30123456", "sexo": "F" }

Exactamente uno de los dos formatos. No se pueden enviar ambos.

Ejemplo de request

curl -X POST https://argenapi.com/api/v1/credit/lookup \
  -H "Authorization: Bearer TU_API_KEY_BURO" \
  -H "Content-Type: application/json" \
  -d '{"cuil": "27301234567"}'

Respuesta exitosa (200)

Respuesta

{
  "success": true,
  "data": {
    "codigo_respuesta": 0,
    "identidad": {
      "apellido_nombre": "GARCIA MARIA LAURA",
      "sexo": "F",
      "edad": 42,
      "fecha_nacimiento": "1984-03-15",
      "fallecido": false
    },
    "score": {
      "score": 650,
      "score_modelo": "H",
      "ses": 5,
      "ses_modelo": "HIT"
    },
    "laboral_actual": {
      "empleador_cuit": "30612345678",
      "empleador_razon_social": "ACME S.A.",
      "empleador_sector": "Privado",
      "empleador_actividad": "Servicios empresariales",
      "fecha_ingreso": "2021-06-01",
      "antiguedad": "Mas de 24 meses",
      "jubilado_pensionado": false
    },
    "bcra_agregados": {
      "situacion_actual": 1,
      "situacion_6m": 1,
      "situacion_12m": 1,
      "compromiso": 15000,
      "monto_total": 450000,
      "cheques_bcra_total": 0,
      "tiene_mora_mercado": false,
      "tiene_mora_historica": false
    },
    "impositivo": {
      "autonomo": false,
      "monotributo": true,
      "ganancias": false,
      "iva": false,
      "sociedad": false,
      "empleador": false,
      "categoria_monotributo": "B"
    },
    "bcra_deudas": [
      {
        "entidad_nombre": "BANCO GALICIA S.A.",
        "entidad_tipo": "BANCO",
        "entidad_codigo": "7",
        "periodo": "202603",
        "situacion": 1,
        "monto": 450000,
        "atraso_dias": 0
      }
    ],
    "empleadores_historicos": [
      {
        "orden": 1,
        "cuit_empleador": "30612345678",
        "razon_social": "ACME S.A.",
        "sector": "Privado",
        "actividad": "Servicios empresariales",
        "antiguedad": "Mas de 24 meses",
        "es_actual": true
      }
    ],
    "domicilios": [],
    "telefonos": [],
    "familiares": [],
    "morosidades_privadas": [],
    "consultas_frecuencia": {
      "dia": 1, "semana": 3, "mes": 5,
      "tres_meses": 8, "seis_meses": 12,
      "ano": 18, "dos_ano": 22
    },
    "consultas_previas_terceros": [],
    "fraude_reportes": []
  },
  "credits_remaining": 44,
  "consulta_id": "a1b2c3d4-...",
  "request_id": "e5f6g7h8-..."
}

Campos de la respuesta

identidad

Campo	Descripción
`apellido_nombre`	Nombre completo (APELLIDO NOMBRE)
`sexo`	"M" o "F"
`edad`	Edad en años
`fecha_nacimiento`	Formato YYYY-MM-DD
`fallecido`	true si la persona falleció

score

Campo	Descripción
`score`	Score crediticio 1-1000 (mayor = mejor)
`score_modelo`	"H" (histórico) o "T" (transaccional)
`ses`	Segmento socioeconómico (1-11, menor = más alto)
`ses_modelo`	Modelo SES utilizado

bcra_deudas

Array de deudas informadas al BCRA, una por combinación entidad × período. Es la sección más importante para evaluar riesgo crediticio.

Campo	Descripción
`entidad_nombre`	Nombre de la entidad acreedora
`entidad_tipo`	BANCO, TARJETA, FINANCIERA, MUTUAL, COOPERATIVA u OTRO
`periodo`	Período YYYYMM (ej: 202603 = marzo 2026)
`situacion`	1=al día, 2=seguimiento, 3=problemas, 4+=alto riesgo
`monto`	Saldo/deuda informado en pesos
`atraso_dias`	Días de atraso (null si no aplica)

bcra_agregados

Campo	Descripción
`situacion_actual`	Peor situación BCRA actual (1-6)
`situacion_6m / 12m / 24m`	Peor situación en ventanas temporales
`compromiso`	Compromiso mensual total en pesos
`monto_total`	Deuda total informada al BCRA
`cheques_bcra_total`	Cantidad de cheques rechazados
`tiene_mora_mercado`	true si tiene mora actual
`tiene_mora_historica`	true si tuvo mora en el pasado

Otras secciones

Sección	Descripción
`laboral_actual`	Empleo actual: empleador, CUIT, sector, antigüedad
`empleadores_historicos[]`	Array de empleos pasados y actuales
`impositivo`	Flags de AFIP: autónomo, monotributo, ganancias, IVA, etc.
`domicilios[]`	Domicilios registrados (dirección, localidad, provincia)
`telefonos[]`	Teléfonos registrados (prefijo, número, tipo)
`familiares[]`	Familiares directos (parentesco, nombre, CUIL)
`morosidades_privadas[]`	Morosidades no bancarias (entidad, categoría, monto)
`consultas_frecuencia`	Frecuencia de consultas: por día, semana, mes, año
`consultas_previas_terceros[]`	Quién consultó a esta persona antes
`fraude_reportes[]`	Reportes de fraude (fecha, tipo, entidad)

Errores

Status	Código	Causa	Consume crédito
`422`	NO_DATA	Persona no encontrada (código 370)	Sí
`409`	DUPLICATES	Múltiples coincidencias	Sí
`422`	INVALID_INPUT	Body no es { cuil } ni { dni, sexo }	No
`403`	FORBIDDEN	Key de otro producto	No
`402`	INSUFFICIENT_CREDITS	Sin créditos	No
`429`	RATE_LIMITED	Exceso de requests	No
`502`	UPSTREAM_ERROR	Error del proveedor	No (se reembolsa)

NO_DATA y DUPLICATES consumen crédito porque el proveedor procesó la consulta. Verificá el CUIL antes de enviar para minimizar consultas fallidas.

Validaciones

CUIL: exactamente 11 dígitos numéricos. Sin guiones ni espacios.
DNI: 7 u 8 dígitos numéricos.
Sexo: "M" o "F" (mayúscula).
Si envías ambos formatos (cuil + dni) o ninguno, recibís 422 INVALID_INPUT.