API para consultar datos de CBU

¿Qué datos devuelve la API?

Cada consulta a la API devuelve un objeto JSON con toda la información asociada al CBU consultado. Los campos principales son:

• Nombre completo del o los titulares de la cuenta.
• CUIT/CUIL de cada titular asociado.
• Banco emisor y código de entidad asignado por el BCRA.
• Tipo de cuenta: caja de ahorro en pesos, cuenta corriente, caja de ahorro en dólares, etc.
• Estado de la cuenta (activa, inactiva, bloqueada).
• Alias asociado al CBU, si existe.

Estos datos te permiten validar la identidad del destinatario antes de ejecutar una transferencia, automatizar procesos de onboarding o enriquecer tu base de datos de proveedores y clientes.

Ejemplo de request

La API usa REST estándar con autenticación Bearer. Acá tenés un ejemplo usando cURL para consultar un CBU:

curl -X GET "https://argenapi.com/api/v1/lookup?identifier=0110599930059999999016&type=cbu" \
  -H "Authorization: Bearer ps_live_TU_API_KEY"

Reemplazá ps_live_TU_API_KEY con tu API Key real. La podés generar desde el dashboard en segundos.

Ejemplo de response

La API responde en formato JSON. Un response típico tiene esta estructura:

{
  "success": true,
  "data": {
    "identifier": "0110599930059999999016",
    "type": "cbu",
    "bank": {
      "name": "Banco de la Nación Argentina",
      "code": "011"
    },
    "account_type": "Caja de ahorro en pesos",
    "status": "active",
    "alias": "CASA.PERRO.ARBOL",
    "holders": [
      {
        "full_name": "GARCÍA MARTÍNEZ JUAN CARLOS",
        "tax_id": "20-28456789-3",
        "tax_id_type": "CUIL"
      }
    ]
  }
}

El campo holders es un array porque una cuenta puede tener más de un titular. Cada holder incluye nombre completo y CUIT/CUIL.

Lenguajes soportados

Al ser una API REST estándar, podés consumirla desde cualquier lenguaje que soporte requests HTTP. Acá van ejemplos rápidos de los más usados:

import requests

resp = requests.get(
    "https://argenapi.com/api/v1/lookup",
    params={"identifier": "0110599930059999999016", "type": "cbu"},
    headers={"Authorization": "Bearer ps_live_TU_API_KEY"}
)
data = resp.json()

const resp = await fetch(
  "https://argenapi.com/api/v1/lookup?identifier=0110599930059999999016&type=cbu",
  { headers: { Authorization: "Bearer ps_live_TU_API_KEY" } }
);
const data = await resp.json();

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://argenapi.com/api/v1/lookup?identifier=0110599930059999999016&type=cbu");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Authorization: Bearer ps_live_TU_API_KEY"]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$data = json_decode($response, true);

También funciona con cURL directamente desde la terminal, como se mostró arriba. Si usás otro lenguaje (Go, Ruby, Java, C#), la integración es igual de simple: un GET con header de autorización.

Autenticación

La API usa autenticación mediante API Keys con esquema Bearer Token. El flujo es simple:

1. Registrate en Argenapi (lleva menos de un minuto).
2. Desde el dashboard, generá una API Key. Podés crear varias keys para distintos entornos (desarrollo, staging, producción).
3. Incluí la key en el header Authorization: Bearer ps_live_TU_API_KEY de cada request.

Las keys con prefijo ps_live_ son para producción. Nunca las expongas en el frontend ni las subas a repositorios públicos. Si una key se compromete, podés revocarla al instante desde el dashboard y generar una nueva.

Precios

Las consultas arrancan desde $999 por consulta. Cuantas más consultas comprás, menor es el precio unitario. Tenemos packs con descuentos progresivos pensados para equipos de desarrollo y empresas que procesan grandes volúmenes.

No hay cargos mensuales ni contratos mínimos. Pagás solo por lo que usás. Para ver todos los planes y calcular tu costo, visitá nuestra página de precios.

Si tu volumen supera las 10.000 consultas mensuales, escribinos para armar un plan a medida con precios preferenciales.

Recursos relacionados

• Precios y packs de consultas
• Guía completa: cómo consultar un CBU por API
• ¿Qué es el CBU? Significado y estructura