Get Virtual Account Debit History

This endpoint allows you to retrieve all debit transactions for a specific virtual account. The response is paginated, providing up to 25 transactions per page.

Endpoint: https://api.chapa.co/v1/virtual-account/history/debit/{account_number}
Method: GET
Authorization: Pass your secret key as a bearer token in the request header
Content-Type: application/json

Path Parameters

Parameter	Required	Type	Description
`account_number`	Yes	string	The virtual account number to fetch history for

cURL

PHP

Python

Successful Response

A successful request returns a list of debit transactions with pagination details:

{
  "status": "success",
  "message": "Virtual Account Debit History Fetched Successfully",
  "data": {
    "current_page": 1,
    "first_page_url": "https://api.chapa.co/v1/virtual-account/history/debit/100700352?page=1",
    "from": 1,
    "next_page_url": null,
    "path": "https://api.chapa.co/v1/virtual-account/history/debit/100700352",
    "per_page": 25,
    "prev_page_url": null,
    "transactions": [
      {
        "chapa_reference": null,
        "Merchant Reference": "VT8x1EwoPF",
        "type": "credit",
        "note": null,
        "amount": 10,
        "currency": "ETB",
        "created_at": "2025-02-17T19:54:47.000000Z",
        "updated_at": "2025-02-17T19:54:47.000000Z"
      }
    ]
  }
}

Response Parameters

Parameter	Type	Description
`status`	string	Status of the request ("success" or "failed")
`message`	string	A message describing the result
`data.current_page`	number	The current page number
`data.first_page_url`	string	URL to the first page of results
`data.from`	number	Starting index of records on current page
`data.next_page_url`	string\|null	URL to the next page (null if on last page)
`data.path`	string	Base path for pagination URLs
`data.per_page`	number	Number of records per page (default: 25)
`data.prev_page_url`	string\|null	URL to the previous page (null if on first page)
`data.transactions`	array	List of transaction objects

Transaction Object Properties

Property	Type	Description
`chapa_reference`	string\|null	Chapa's reference for the transaction (can be null)
`Merchant Reference`	string	Your reference for the transaction
`type`	string	Type of transaction (e.g., "credit", "debit")
`note`	string\|null	Transaction note or description (can be null)
`amount`	number	Transaction amount
`currency`	string	Transaction currency (e.g., "ETB")
`created_at`	string	Timestamp of transaction creation
`updated_at`	string	Timestamp of last transaction update

Failed Response

{
  "message": "Invalid API Key",
  "status": "failed",
  "data": null
}

Refer to our Error Codes page for all responses for this request.

Pagination

The response includes pagination information to help you navigate through multiple pages of transactions. Use the next_page_url and prev_page_url fields to fetch additional pages.

Use Cases

Transaction Auditing: Review all debit transactions for an account
Reconciliation: Reconcile account debits with your records
Reporting: Generate reports on account withdrawals
Customer Support: Help customers track their transaction history

Next Steps

Deduct from Virtual Account - Withdraw funds from virtual account
Get Virtual Account Credit History - View credit transaction history
Get Virtual Account - Retrieve virtual account details
Error Codes - Handle errors gracefully

Get Virtual Account Debit History

On this page