The Get Transactions API returns a paginated list of transactions for a merchant virtual account. It covers the same data as the Ledger page of the Admin Dashboard, and is useful for reconciliation or building your own reporting.

Before you start

You need the providerBankAccountId for the account you want to query. Retrieve this by calling the Get Corporate Accounts API, which returns the list of virtual accounts associated with your merchant.

Request

GET {{baseUrl}}/v2/corporate-account/transactions/{providerBankAccountId}

Environment	Base URL
Production	`https://api.yaspa.com`
Test	`https://testapi.yaspa.com`

Headers

Header	Description
`AuthorizationCitizen`	Your merchant private API key

Parameters

Parameter	In	Type	Required	Description
`providerBankAccountId`	path	string	Yes	The virtual account identifier, from Get Corporate Accounts.
`page`	query	integer	Yes	Zero-based page number. Start at `0`.
`size`	query	integer	Yes	Number of results per page.
`dateFrom`	query	string	No	Start of the date range (ISO 8601).
`dateTo`	query	string	No	End of the date range (ISO 8601).

Sample request

curl --request GET \
  --url 'https://api.yaspa.com/v2/corporate-account/transactions/abc123?page=0&size=20&dateFrom=2026-10-01&dateTo=2026-10-31' \
  --header 'AuthorizationCitizen: {private API key}'

Pagination

Results are returned one page at a time. Increment page to retrieve subsequent pages. If a page returns fewer results than size, you have reached the last page. The response does not include a total count, so iterate until you get an empty or short page.

For the full request and response definition, see the Get Transactions reference page.