---
agentTools:
  projectIndex: https://safehavenmfb.readme.io/llms.txt
---

# Get Account Statement

This returns the account statement for a set date range for the specified account

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Safe Haven IBS API",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://api.sandbox.safehavenmfb.com"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "oauth2",
        "flows": {
          "clientCredentials": {
            "tokenUrl": "https://example.com/oauth2/token",
            "scopes": {}
          }
        }
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/accounts/{id}/statement": {
      "get": {
        "summary": "Get Account Statement",
        "description": "This returns the account statement for a set date range for the specified account",
        "operationId": "get-account-statement",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "description": "The `_id` of the account.",
            "schema": {
              "type": "string"
            },
            "required": true
          },
          {
            "name": "page",
            "in": "query",
            "description": "This represents the position the results should begin from. 0 represents the first position.",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 0
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "This is the maximum number of accounts to be fetched for this request.",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 100
            }
          },
          {
            "name": "fromDate",
            "in": "query",
            "description": "This is the start date of the period you wish to fetch the statement for.",
            "schema": {
              "type": "string",
              "format": "date"
            }
          },
          {
            "name": "toDate",
            "in": "query",
            "description": "This is the end date of the period you wish to fetch the statement for.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "type",
            "in": "query",
            "description": "The type of transaction you wish to fetch for",
            "schema": {
              "type": "string",
              "enum": [
                "Credit",
                "Debit"
              ]
            }
          },
          {
            "name": "ClientID",
            "in": "header",
            "description": "This is your 'ibs_client_id' returned in the response when you generate an api token",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n    \"statusCode\": 200,\n    \"message\": \"Account Statement fetched successfully.\",\n    \"data\": [\n        {\n            \"isReversal\": false,\n            \"_id\": \"691f19f91247ec00240fc2f9\",\n            \"cbaTransactionId\": null,\n            \"client\": \"6874eb47aaad890024be3930\",\n            \"account\": {\n                \"canDebit\": true,\n                \"canCredit\": true,\n                \"_id\": \"6874eb48aaad890024be3931\",\n                \"client\": \"6874eb47aaad890024be3930\",\n                \"accountProduct\": \"60d7bd5fa4884c30a832e37a\",\n                \"accountNumber\": \"0117964837\",\n                \"accountName\": \"PRIMETECH\",\n                \"accountType\": \"Current\",\n                \"currencyCode\": \"NGN\",\n                \"bvn\": \"22001234567\",\n                \"accountBalance\": 12175562.829999998,\n                \"bookBalance\": 12175562.829999998,\n                \"interestBalance\": 0,\n                \"withHoldingTaxBalance\": 0,\n                \"status\": \"Active\",\n                \"isDefault\": true,\n                \"nominalAnnualInterestRate\": 0,\n                \"interestCompoundingPeriod\": \"Daily\",\n                \"interestPostingPeriod\": \"Monthly\",\n                \"interestCalculationType\": \"DailyBalance\",\n                \"interestCalculationDaysInYearType\": \"365\",\n                \"minRequiredOpeningBalance\": 0,\n                \"lockinPeriodFrequency\": 0,\n                \"lockinPeriodFrequencyType\": \"Days\",\n                \"allowOverdraft\": false,\n                \"overdraftLimit\": 0,\n                \"chargeWithHoldingTax\": true,\n                \"chargeValueAddedTax\": true,\n                \"chargeStampDuty\": true,\n                \"notificationSettings\": {\n                    \"smsNotification\": true,\n                    \"emailNotification\": true,\n                    \"emailMonthlyStatement\": true,\n                    \"smsMonthlyStatement\": true\n                },\n                \"isSubAccount\": false,\n                \"isDeleted\": false,\n                \"createdAt\": \"2025-07-14T11:34:32.006Z\",\n                \"updatedAt\": \"2025-11-24T08:58:41.880Z\",\n                \"__v\": 0,\n                \"cbaAccountId\": \"26372\"\n            },\n            \"paymentReference\": \"999240251120133905106419049906\",\n            \"type\": \"Debit\",\n            \"provider\": \"BANK\",\n            \"providerChannel\": \"TRANSFER\",\n            \"paymentServices\": \"Transfer\",\n            \"narration\": \"Internal Fund Transfer|||BORDERLESSPAYSO / JOHN DOE\",\n            \"amount\": 10000,\n            \"runningBalance\": 12175562.829999998,\n            \"transactionDate\": \"2025-11-20T13:39:05.540Z\",\n            \"valueDate\": \"2025-11-20T13:39:05.540Z\",\n            \"__v\": 0\n        },\n\t\t\t\t...\n    ],\n    \"pagination\": {\n        \"total\": 76,\n        \"pages\": 4,\n        \"page\": \"0\",\n        \"limit\": \"25\"\n    }\n}"
                  }
                }
              }
            }
          },
          "400": {
            "description": "400",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {}
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true,
  "_id": "61e69ed05b7bd4006a962eed:61ea7d96f6a9da01af6d986d"
}
```