Consultar CBU/Alias

Consultá el titular de cualquier CBU (22 dígitos) o Alias bancario argentino.

GET/api/v1/lookup—Consultar titular de CBU o Alias

Parámetros

Parámetro	Tipo	Obligatorio	Descripción
`identifier`	string	Sí	CBU (22 dígitos numéricos) o Alias bancario
`type`	string	Sí	"cbu" o "alias"

Ejemplo de request

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

Respuesta exitosa (200)

Respuesta

{
  "success": true,
  "data": {
    "holders": [
      {
        "full_name": "Pérez, Juan Carlos",
        "tax_id": "20304050607",
        "tax_id_type": "CUIT",
        "is_individual": true
      }
    ],
    "account_type": "CC",
    "active": true,
    "currency": "ARS",
    "alias": "juanperez.mp",
    "account": {
      "scheme": "CBU",
      "number": "0070026930004037264164"
    },
    "bank": {
      "name": "BANCO DE GALICIA Y BUENOS AIRES S.A.U.",
      "code": "007"
    }
  },
  "credits_remaining": 9,
  "request_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

Campos de la respuesta

Campo	Descripción
`holders[].full_name`	Nombre del titular
`holders[].tax_id`	CUIT/CUIL del titular
`holders[].tax_id_type`	Tipo: CUIT, CUIL
`holders[].is_individual`	true = persona física, false = jurídica
`account_type`	Tipo de cuenta: CC (corriente), CA (ahorro), VIRTUAL
`active`	Estado de la cuenta
`currency`	Moneda (ARS, USD)
`account.number`	CBU/CVU completo
`account.scheme`	Tipo: CBU o CVU
`bank.name`	Nombre del banco
`bank.code`	Código BCRA del banco
`credits_remaining`	Créditos restantes después de la consulta
`request_id`	ID único para soporte

Errores

Status	Código	Causa	Consume crédito
`400`	PA006	CBU o Alias inválido	Sí
`404`	PA011	No encontrado	Sí
`402`	INSUFFICIENT_CREDITS	Sin créditos	No
`401`	UNAUTHORIZED	API key inválida	No
`429`	RATE_LIMITED	Exceso de requests	No

Las consultas exitosas y los errores de validación/búsqueda (PA006, PA011) consumen crédito. Los errores del sistema (GE500, RATE_LIMITED, etc.) no consumen.

Validaciones

CBU: exactamente 22 dígitos numéricos. Se rechazan caracteres especiales.
Alias: mínimo 6 caracteres. Solo letras, números y puntos.

AnteriorEndpoints SiguienteSaldo de créditos