Skip to main content
Returns all payments received into a specific virtual account, with filtering and pagination. 
POST /business/virtual-account/history/{account_number}

​
Path Parameters

​
account_number
string
required
The account number (not the account ID).

​
Query Parameters

​
customer_id
string
Filter by customer ID.
​
status
string
Filter by payment status.
​
start_date
string
From date (ISO 8601), e.g. 2026-04-01.
​
end_date
string
To date (ISO 8601), e.g. 2026-04-30.
​
page
number
Page number.
​
per_page
number
Results per page.
curl -X POST 'https://api.yativo.com/api/v1/business/virtual-account/history/9900123456?start_date=2026-04-01&end_date=2026-04-30&per_page=20' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'

{
  "status": "success",
  "status_code": 200,
  "message": "Records retrieved successfully",
  "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"
    }
  ],
  "pagination": {
    "total": 12,
    "per_page": 20,
    "current_page": 1
  }
}