curl -X GET 'https://api.yativo.com/api/v1/business/virtual-account?currency=BRL&per_page=20' \
-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"
}
],
"pagination": {
"total": 8,
"per_page": 20,
"current_page": 1,
"last_page": 1,
"next_page_url": null,
"prev_page_url": null
}
}
Virtual Accounts
List Virtual Accounts
Retrieve all virtual accounts associated with your business
GET
/
business
/
virtual-account
curl -X GET 'https://api.yativo.com/api/v1/business/virtual-account?currency=BRL&per_page=20' \
-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"
}
],
"pagination": {
"total": 8,
"per_page": 20,
"current_page": 1,
"last_page": 1,
"next_page_url": null,
"prev_page_url": null
}
}
Returns all virtual accounts for your business with optional filtering.
GET /v1/business/virtual-account
curl -X GET 'https://api.yativo.com/api/v1/business/virtual-account?currency=BRL&per_page=20' \
-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"
}
],
"pagination": {
"total": 8,
"per_page": 20,
"current_page": 1,
"last_page": 1,
"next_page_url": null,
"prev_page_url": null
}
}
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.
Query Parameters
Filter by currency code (e.g. BRL, USD).
Filter by account status.
From date (ISO 8601), e.g. 2026-04-01.
To date (ISO 8601), e.g. 2026-04-30.
Search by account name or account number.
Results per page.