Account Ministatement

Account Mini-statement

Test URL

GEThttps://uat.finserve.africa/v3-apis/account-api/v3.0/accounts/miniStatement/{countryCode}/{accountNumber}

Live URL

GEThttps://api.finserve.africa/v3-apis/account-api/v3.0/accounts/miniStatement/{countryCode}/{accountNumber}

This service will return the last (10) ten transactions of a given account number. Its a super efficient service compared to the fullstatement web service.

URL Parameters

Parameter	Type	Description	Example	Required
`countryCode`	string	The ISO Alpha-2 country code of the account's location.	"KE"	Yes
`accountNumber`	string	The account number for which to retrieve the mini-statement.	"00201XXXX14605"	Yes

Example Request

⚠️

In the example below, please remember to replace the variables enclosed within curly brackets {{ }} with the actual values.

Signature Formulae e.g. KE1450160649886

countryCode+accountNumber

Example Request

curl -X GET \
	-H 'Authorization: Bearer {{access_token}}'  \
	-H 'signature: {{signature}}'  \
	-L 'https://uat.finserve.africa/v3-apis/account-api/v3.0/accounts/miniStatement/KE/00201XXXX14605'

200 Success Response Schema

Field Name	Field Type	Field Description
`status`	`bool`	Response status
`code`	`number`	Response code
`message`	`string`	Response message
`accountNumber`	`string`	account number
`currency`	`string`	account currency
`balance`	`string`	account available balance
`transactions`	`array`	transactions list
`date`	`string`	transaction date
`chequeNumber`	`string`	cheque number. Applicable to current accounts only
`description`	`string`	transaction description
`amount`	`string`	transaction amount
`type`	`string`	transaction type

Example Response

{
   "status":true,
   "code":0,
   "message":"success",
   "data":{
      "accountNumber":"00201XXXX14605",
      "currency":"KES",
      "balance":1000,
      "transactions":[
         {
            "chequeNumber":null,
            "date":"2017-01-01T00:00:00",
            "description":"EAZZY-FUNDS TRNSF TO A/C XXXXXXXXXXXX",
            "amount":"100",
            "type":"Debit"
         },
         {
            "chequeNumber":null,
            "date":"2017-01-03T00:00:00",
            "description":"SI ACCOUNT TO ACCOUNT THIRD PA",
            "amount":"51",
            "type":"Debit"
         },
         {
            "chequeNumber":null,
            "date":"2017-01-05T00:00:00",
            "description":"CHARGE FOR OTC ECS TRAN",
            "amount":"220",
            "type":"Debit"
         },
         {
            "chequeNumber":null,
            "date":"2017-01-05T00:00:00",
            "description":"SI ACCOUNT TO ACCOUNT THIRD PA",
            "amount":"20",
            "type":"Debit"
         }
      ]
   }
}

Account Balance Account Full Statement