> ## Documentation Index
> Fetch the complete documentation index at: https://docs.velafi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Consultar un alias (ARS)

> Consulta el CBU/CVU, el estado y los titulares de la cuenta detrás de un alias de cuenta argentino.

Usa este endpoint para resolver un alias de cuenta argentino al CBU/CVU al que apunta, junto con el estado de la cuenta y los titulares registrados.

> [!NOTE]
>
> Todas las solicitudes deben incluir el header `X-BH-TOKEN` con un token de acceso. Consulta [Autenticación](https://docs.velafi.com/es/api-reference/authentication.md). Este endpoint devuelve `code` `0` y `msg` `success` cuando la solicitud es exitosa, no `200`/`SUCCESS`.

## Endpoint

`GET https://api.velafi.com/v2/merchant/check/alias`

## Parámetros de consulta

**alias** `string` *required*

El alias que se va a consultar.

Si el alias no se puede resolver, la solicitud falla con un error de parámetro inválido.

## Campos de la respuesta

**code** `number`

`0` indica éxito.

**msg** `string`

`success` si la solicitud es exitosa.

**data** `object`

**campos de data**

**alias** `string`

El alias actual de la cuenta.

**cbu** `string`

El CBU/CVU al que apunta actualmente el alias.

**activa** `boolean`

Indica si la cuenta está activa.

**freezed** `boolean`

Indica si el CBU/CVU está bloqueado.

**openTime** `number`

Fecha y hora de apertura del CBU/CVU (marca de tiempo Unix en milisegundos).

**titulares** `array`

Titulares de la cuenta.

**campos de cada elemento de titulares**

**type** `number`

Tipo de titular: `1` = persona física, `2` = persona jurídica.

**cuit** `string`

CUIT del titular.

**accountName** `string`

Nombre del titular.

## Ejemplo

```bash cURL theme={null}
curl -G https://api.velafi.com/v2/merchant/check/alias \
  -H "X-BH-TOKEN: YOUR_ACCESS_TOKEN" \
  --data-urlencode "alias=example.alias"
```


## Related topics

- [Consultar un CVU/CBU (ARS)](https://docs.velafi.com/es/api-reference/beneficiary/check-cvu.md)
- [Activar la cuenta de un comercio persona física](https://docs.velafi.com/es/api-reference/merchant/activate-merchant-account-for-individual.md)
- [Activar la cuenta de un comercio](https://docs.velafi.com/es/docs/guides/activating-merchant-account.md)
- [Activar la cuenta de un comercio empresa](https://docs.velafi.com/es/api-reference/merchant/activate-merchant-account-for-business.md)
- [Crear cuentas virtuales](https://docs.velafi.com/es/api-reference/merchant/create-multiple-virtual-account.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.