curl --request POST \
--url https://hg.cash/api/v1/alias-lookup \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"alias": "miempresa.cbu"
}
'{
"alias": "<string>",
"cuit": "<string>",
"cvu": "<string>",
"nombre": "<string>",
"tipoPersona": "<string>"
}{
"error": "Not found",
"message": "No information found for this CVU or alias"
}{
"error": "Invalid request",
"code": "INSUFFICIENT_NET_BALANCE",
"message": "The provided data is invalid",
"details": {
"field": "amount",
"code": "INVALID_VALUE"
}
}{
"error": "Access denied",
"code": "ALIAS_LOOKUP_NOT_ENABLED",
"message": "This user does not have access to the alias lookup service. Contact your administrator."
}{
"error": "Invalid request",
"code": "INSUFFICIENT_NET_BALANCE",
"message": "The provided data is invalid",
"details": {
"field": "amount",
"code": "INVALID_VALUE"
}
}Reference Data
Look up CVU or Alias
Look up beneficiary information by CVU (22 digits) or alias. Returns alias, CUIT, CVU, name, and person type.
Paid service: This endpoint is a paid feature. Usage may incur charges. Consult your accountant or HG.Cash billing team for pricing details.
POST
/
alias-lookup
curl --request POST \
--url https://hg.cash/api/v1/alias-lookup \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"alias": "miempresa.cbu"
}
'{
"alias": "<string>",
"cuit": "<string>",
"cvu": "<string>",
"nombre": "<string>",
"tipoPersona": "<string>"
}{
"error": "Not found",
"message": "No information found for this CVU or alias"
}{
"error": "Invalid request",
"code": "INSUFFICIENT_NET_BALANCE",
"message": "The provided data is invalid",
"details": {
"field": "amount",
"code": "INVALID_VALUE"
}
}{
"error": "Access denied",
"code": "ALIAS_LOOKUP_NOT_ENABLED",
"message": "This user does not have access to the alias lookup service. Contact your administrator."
}{
"error": "Invalid request",
"code": "INSUFFICIENT_NET_BALANCE",
"message": "The provided data is invalid",
"details": {
"field": "amount",
"code": "INVALID_VALUE"
}
}Authorizations
User API authentication token with format cash_<64-char-hex>. Sample value cash_16cdc3b6f83c72d9d2680adca4f430962981f6bf32613a129dded0aa060387d2.
Body
application/json
CVU (22 digits) or alias to look up
Example:
"miempresa.cbu"

