curl -X GET 'https://api.yativo.com/api/v1/business/virtual-account/histories' \
-H 'X-Api-Key: YOUR_API_KEY' \
-H 'X-Api-Secret: YOUR_API_SECRET'
{
"status": "success",
"status_code": 200,
"message": "Request successful",
"data": [
{
"amount": 1000,
"currency": "BRL",
"status": "completed",
"credited_amount": 950,
"transaction_id": "TXNMP2HK81BHJ",
"sender_name": "John Smith",
"account_number": "9900123456",
"transaction_fees": 50,
"created_at": "2026-04-01T10:00:00Z"
},
{
"amount": 500,
"currency": "CLP",
"status": "completed",
"credited_amount": 480,
"transaction_id": "TXNQR3JL92CIK",
"sender_name": "Ana Rodriguez",
"account_number": "9900654321",
"transaction_fees": 20,
"created_at": "2026-04-02T14:30:00Z"
}
]
}
Virtual Accounts
All Virtual Account Histories
Retrieve deposit histories across all virtual accounts for your business
GET
/
business
/
virtual-account
/
histories
curl -X GET 'https://api.yativo.com/api/v1/business/virtual-account/histories' \
-H 'X-Api-Key: YOUR_API_KEY' \
-H 'X-Api-Secret: YOUR_API_SECRET'
{
"status": "success",
"status_code": 200,
"message": "Request successful",
"data": [
{
"amount": 1000,
"currency": "BRL",
"status": "completed",
"credited_amount": 950,
"transaction_id": "TXNMP2HK81BHJ",
"sender_name": "John Smith",
"account_number": "9900123456",
"transaction_fees": 50,
"created_at": "2026-04-01T10:00:00Z"
},
{
"amount": 500,
"currency": "CLP",
"status": "completed",
"credited_amount": 480,
"transaction_id": "TXNQR3JL92CIK",
"sender_name": "Ana Rodriguez",
"account_number": "9900654321",
"transaction_fees": 20,
"created_at": "2026-04-02T14:30:00Z"
}
]
}
Returns deposit histories across all virtual accounts associated with the authenticated business. Use this to get a consolidated view of all incoming payments without querying each account individually.
GET /v1/business/virtual-account/histories
curl -X GET 'https://api.yativo.com/api/v1/business/virtual-account/histories' \
-H 'X-Api-Key: YOUR_API_KEY' \
-H 'X-Api-Secret: YOUR_API_SECRET'
{
"status": "success",
"status_code": 200,
"message": "Request successful",
"data": [
{
"amount": 1000,
"currency": "BRL",
"status": "completed",
"credited_amount": 950,
"transaction_id": "TXNMP2HK81BHJ",
"sender_name": "John Smith",
"account_number": "9900123456",
"transaction_fees": 50,
"created_at": "2026-04-01T10:00:00Z"
},
{
"amount": 500,
"currency": "CLP",
"status": "completed",
"credited_amount": 480,
"transaction_id": "TXNQR3JL92CIK",
"sender_name": "Ana Rodriguez",
"account_number": "9900654321",
"transaction_fees": 20,
"created_at": "2026-04-02T14:30:00Z"
}
]
}
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.