> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.haloinvest.ng/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.haloinvest.ng/_mcp/server. # Get account statement POST https://api.haloinvest.ng/api/banking/account/statement Content-Type: application/json Returns the statement of an account your business opened. Without dates, the statement runs from 90 days ago to the end of the current month. The end date is moved to the last day of its month. Dates in the response use DD-MM-YYYY. A validation failure here answers 400 with the first error as the message. Reference: https://docs.haloinvest.ng/api-reference/transactions-and-statements/get-account-statement ## Authentication - `Authorization` header (bearer token, required) — Your Halo partner API key, sent as `Authorization: Bearer `. ## Request ### Body (application/json) This endpoint expects an object. - `account_number` (string, required) — An account number your business opened. 10 digits. - `start_date` (date, optional, nullable) — Start date. On or before end_date. - `end_date` (date, optional, nullable) — End date. On or after start_date. - `customer_reference` (string, optional, nullable) — Your own reference, echoed back. At most 255 characters. ## Response ### 200 The statement. - `status` (boolean, required) — True on success, false otherwise. - `message` (EnvelopeMessage, required) — A short message. On a 422 validation failure it is an object of field names to error lists. - `status_code` (integer, required) — The HTTP status code. - `data` (any, optional) — The result. Left out on most errors. ## Errors ### 400 Bad Request Error The request failed validation, or the statement could not be read. - `status` (boolean, required) — True on success, false otherwise. - `message` (EnvelopeMessage, required) — A short message. On a 422 validation failure it is an object of field names to error lists. - `status_code` (integer, required) — The HTTP status code. - `data` (any, optional) — The result. Left out on most errors. ### 401 Unauthorized Error The API key is missing or not recognised, or your business is switched off. - `error` (UnauthorizedErrorError, optional) ### 404 Not Found Error The account is not one your business opened. - `status` (boolean, required) — True on success, false otherwise. - `message` (EnvelopeMessage, required) — A short message. On a 422 validation failure it is an object of field names to error lists. - `status_code` (integer, required) — The HTTP status code. - `data` (any, optional) — The result. Left out on most errors. ### 429 Too Many Requests Error Too many requests. Wait and try again. - `status` (boolean, required) — True on success, false otherwise. - `message` (EnvelopeMessage, required) — A short message. On a 422 validation failure it is an object of field names to error lists. - `status_code` (integer, required) — The HTTP status code. - `data` (any, optional) — The result. Left out on most errors. ### 500 Internal Server Error The statement service failed. - `status` (boolean, required) — True on success, false otherwise. - `message` (EnvelopeMessage, required) — A short message. On a 422 validation failure it is an object of field names to error lists. - `status_code` (integer, required) — The HTTP status code. - `data` (any, optional) — The result. Left out on most errors. ## Types ### EnvelopeMessage A short message. On a 422 validation failure it is an object of field names to error lists. - string - map from string to list of string ### UnauthorizedErrorError - `message` (string, optional) ## Examples **Request** ```json { "account_number": "1100000001" } ``` **Response** ```json { "status": true, "message": "Account statement retrieved successfully", "status_code": 200, "data": null } ``` **SDK Code** ```python Transactions and statements_getAccountStatement_example import requests url = "https://api.haloinvest.ng/api/banking/account/statement" payload = { "account_number": "1100000001" } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Transactions and statements_getAccountStatement_example const url = 'https://api.haloinvest.ng/api/banking/account/statement'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"account_number":"1100000001"}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Transactions and statements_getAccountStatement_example package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.haloinvest.ng/api/banking/account/statement" payload := strings.NewReader("{\n \"account_number\": \"1100000001\"\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Transactions and statements_getAccountStatement_example require 'uri' require 'net/http' url = URI("https://api.haloinvest.ng/api/banking/account/statement") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"account_number\": \"1100000001\"\n}" response = http.request(request) puts response.read_body ``` ```java Transactions and statements_getAccountStatement_example import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.haloinvest.ng/api/banking/account/statement") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"account_number\": \"1100000001\"\n}") .asString(); ``` ```php Transactions and statements_getAccountStatement_example request('POST', 'https://api.haloinvest.ng/api/banking/account/statement', [ 'body' => '{ "account_number": "1100000001" }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Transactions and statements_getAccountStatement_example using RestSharp; var client = new RestClient("https://api.haloinvest.ng/api/banking/account/statement"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"account_number\": \"1100000001\"\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Transactions and statements_getAccountStatement_example import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = ["account_number": "1100000001"] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.haloinvest.ng/api/banking/account/statement")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```