OPEN BANKING DOCSGet account statement (Open Banking v2)
Retrieve account statement from Keystone for the specified date range. Charges a per-call fee from the debit account to the settlement account. Idempotent per (from,to) range using idempotencyKey.
X-API-Key<token>
In: header
Header Parameters
X-API-Keystring
API key for the application
X-App-Idstring
UUID of the application
Format
uuidappIdstring
Application ID
Format
uuidreadAccountNumberstring
Keystone account number to query statement for
Match
^[0-9]{10}$debitAccountNumberstring
Account number to debit fee from (must belong to appId)
Match
^[0-9]{10}$fromstring
Start date/time for statement period
Format
date-timetostring
End date/time for statement period
Format
date-timecurrencystring
Currency code
Value in
"NGN" | "USD" | "EUR" | "GBP"page?integer | null
Page number for pagination
Range
1 <= valuesize?integer | null
Page size for pagination
Range
1 <= value <= 200idempotencyKey?string | null
Optional idempotency key for duplicate prevention
Response Body
curl -X POST "https://virtual-accounts-api.vantacrest.com/company/v1/open-banking/v2/summary" \ -H "X-API-Key: string" \ -H "X-App-Id: 497f6eca-6276-4993-bfeb-53cbbbba6f08" \ -H "Content-Type: application/json" \ -d '{ "appId": "28c365d5-df94-4a54-8217-3ce51d068868", "readAccountNumber": "string", "debitAccountNumber": "string", "from": "2019-08-24T14:15:22Z", "to": "2019-08-24T14:15:22Z", "currency": "NGN" }'{
"data": {
"accountNumber": "string",
"currency": "string",
"periodStart": "2019-08-24T14:15:22Z",
"periodEnd": "2019-08-24T14:15:22Z",
"openingBalance": 0,
"closingBalance": 0,
"totalCredits": 0,
"totalDebits": 0,
"transactions": [
{
"transactionId": "string",
"date": "2019-08-24T14:15:22Z",
"description": "string",
"debit": 0,
"credit": 0,
"balance": 0
}
],
"feeApplied": true,
"feeAmount": 0,
"feeCurrency": "string",
"feeTransactionId": "string",
"settlementStatus": "PENDING",
"correlationId": "string"
}
}{
"success": true,
"message": "string",
"data": {},
"timestamp": "2019-08-24T14:15:22Z"
}{
"success": true,
"message": "string",
"data": {},
"timestamp": "2019-08-24T14:15:22Z"
}{
"success": true,
"message": "string",
"data": {},
"timestamp": "2019-08-24T14:15:22Z"
}