> ## 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.

# Obtener los detalles de la cuenta

> Obtén la información básica de la cuenta del usuario autenticado, incluidos el nombre de la empresa, el país, el estado de KYC y los límites de transacción mensuales.

El endpoint `GET /v2/user/account` devuelve la información principal de la cuenta asociada a tu clave de API: el nombre de la empresa, el país de registro, el estado de verificación KYC y el límite de transacción mensual, junto con cuánto de ese límite ya consumiste en el mes calendario en curso. Usa este endpoint para verificar el estado de la cuenta o para habilitar funciones en tu aplicación según el estado de KYC o la capacidad mensual restante.

## Endpoint

| Propiedad | Valor |
| - | - |
| **Método** | `GET` |
| **Ruta** | `/v2/user/account` |
| **Autenticación** | Obligatoria — header `X-BH-TOKEN` |
| **Cuerpo de la solicitud** | Ninguno |

## Parámetros de la solicitud

Este endpoint no recibe parámetros de consulta ni cuerpo de solicitud. La autenticación es el único requisito.

## Campos de la respuesta

**code** `number` *required*

El código numérico de respuesta. `200` indica una respuesta exitosa.

**msg** `string` *required*

Un mensaje breve que describe el resultado. Devuelve `"SUCCESS"` cuando la solicitud es exitosa.

**data** `object` *required*

Un objeto que contiene los detalles de la cuenta del usuario autenticado.

**campos de data**

**userId** `number` *required*

El identificador numérico único de la cuenta del usuario autenticado.

**country** `string` *required*

El nombre completo del país en el que está registrada la cuenta (por ejemplo, `"Argentina"`).

**companyName** `string` *required*

La razón social de la empresa asociada a esta cuenta.

**kycPassed** `boolean` *required*

Indica si la cuenta completó correctamente el proceso de verificación KYC (Know Your Customer). La creación de órdenes y los pagos normalmente están bloqueados hasta que este valor sea `true`.

**monthLimit** `number` *required*

El límite total de transacciones mensuales de esta cuenta, expresado en USD. Por ejemplo, `250000.0` representa un tope mensual de \$250,000.

**monthUsed** `number` *required*

El valor acumulado en USD de las transacciones procesadas en el mes calendario en curso. Se restablece a `0.0` al inicio de cada mes.

## Ejemplo de solicitud

```bash theme={null}
curl --request GET \
  --url https://api.velafi.com/v2/user/account \
  --header "X-BH-TOKEN: your_token"
```

**Equivalente en sandbox**

```bash theme={null}
curl --request GET \
  --url https://api-test.velafi.com/v2/user/account \
  --header "X-BH-TOKEN: your_sandbox_token"
```

## Ejemplo de respuesta

```json theme={null}
{
  "code": 200,
  "msg": "SUCCESS",
  "data": {
    "userId": 1,
    "country": "Argentina",
    "companyName": "velafi",
    "kycPassed": true,
    "monthLimit": 250000.0,
    "monthUsed": 0.0
  }
}
```

> [!NOTE]
>
> El campo `kycPassed` refleja si tu cuenta completó el proceso de verificación Know Your Customer. Si `kycPassed` es `false`, contacta al soporte de VelaFi o completa los pasos de KYC en el portal del comercio antes de intentar crear órdenes reales.

> [!TIP]
>
> Calcula `monthLimit` menos `monthUsed` antes de enviar órdenes grandes para confirmar que tienes suficiente capacidad restante en el mes en curso. Si necesitas un límite mensual más alto, contacta al [soporte de VelaFi](mailto:support@velafi.com).


## Related topics

- [Registro de cambios](https://docs.velafi.com/es/docs/changelog.md)
- [On-ramp (fiat a cripto)](https://docs.velafi.com/es/docs/guides/on-ramp.md)
- [Administrar beneficiarios](https://docs.velafi.com/es/docs/guides/managing-beneficiaries.md)
- [Obtener la cuenta Pending Fund](https://docs.velafi.com/es/api-reference/merchant/get-pending-fund-account.md)
- [Listar cuentas de comercio](https://docs.velafi.com/es/api-reference/merchant/get-a-list-of-merchant-accounts.md)


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