curl -X GET 'https://api.yativo.com/api/v1/business/virtual-account/show/va_xxxxxx' \
-H 'X-Api-Key: YOUR_API_KEY' \
-H 'X-Api-Secret: YOUR_API_SECRET'
{
"status": "success",
"status_code": 200,
"message": "Request successful",
"data": {
"account_id": "va_xxxxxx",
"account_number": "9900123456",
"account_type": "savings",
"currency": "BRL",
"customer_id": "da44a3e6-eb5d-429f-8d17-357aa5a6cdf2",
"status": "active",
"created_at": "2026-04-01T10:00:00Z"
}
}
{
"status": "failed",
"status_code": 404,
"message": "Request failed.",
"data": {
"error": "Virtual account not found"
}
}
Virtual Accounts
Get Virtual Account
Retrieve details for a specific virtual account
GET
/
business
/
virtual-account
/
show
/
{externalId}
curl -X GET 'https://api.yativo.com/api/v1/business/virtual-account/show/va_xxxxxx' \
-H 'X-Api-Key: YOUR_API_KEY' \
-H 'X-Api-Secret: YOUR_API_SECRET'
{
"status": "success",
"status_code": 200,
"message": "Request successful",
"data": {
"account_id": "va_xxxxxx",
"account_number": "9900123456",
"account_type": "savings",
"currency": "BRL",
"customer_id": "da44a3e6-eb5d-429f-8d17-357aa5a6cdf2",
"status": "active",
"created_at": "2026-04-01T10:00:00Z"
}
}
{
"status": "failed",
"status_code": 404,
"message": "Request failed.",
"data": {
"error": "Virtual account not found"
}
}
Returns full details for a specific virtual account by its external ID.
GET /v1/business/virtual-account/show/{externalId}
curl -X GET 'https://api.yativo.com/api/v1/business/virtual-account/show/va_xxxxxx' \
-H 'X-Api-Key: YOUR_API_KEY' \
-H 'X-Api-Secret: YOUR_API_SECRET'
{
"status": "success",
"status_code": 200,
"message": "Request successful",
"data": {
"account_id": "va_xxxxxx",
"account_number": "9900123456",
"account_type": "savings",
"currency": "BRL",
"customer_id": "da44a3e6-eb5d-429f-8d17-357aa5a6cdf2",
"status": "active",
"created_at": "2026-04-01T10:00:00Z"
}
}
{
"status": "failed",
"status_code": 404,
"message": "Request failed.",
"data": {
"error": "Virtual account not found"
}
}
Authorizations
Your API key (yativo_pk_...) from Developers → API Keys. Send together with X-Api-Secret.
Your API secret (yativo_sk_...), shown once when the key is created.
Path Parameters
The external ID of the virtual account.

