---
title: "Get Balance History"
method: GET
path: "/wallets/logs"
---

# Get Balance History

`GET /wallets/logs`

This endpoint fetches all pay-ins and pay-outs that occurred on your integration

## Request body

- object
  - `business` string, required — The unique Identifier of the parent business or sub account
  - `action` string — This means debit or credit e.g debit/credit
  - `dateFrom` string — The start date.This must be in ISO 8601 date format(YYYY-MM-DD)
  - `dateTo` string — The end date.This must be in ISO 8601 date format(YYYY-MM-DD)
  - `page` string — Specify exactly what page you want to retrieve
  - `perPage` string — How many records page you want to retrieve per page
  - `amount` string

## Response `200`

200

- object
  - `success` boolean
  - `message` string
  - `data` object
    - `results` object[]
      - `id` integer
      - `reference` string
      - `createdAt` string
      - `description` string
      - `action` string
      - `amount` integer
      - `currency` string
      - `method` string
      - `reason` string
      - `merchantDescription` unknown
      - `availableBalanceBefore` integer
      - `availableBalanceAfter` integer
      - `ledgerBalanceBefore` integer
      - `ledgerBalanceAfter` integer
      - `lockedBalanceBefore` integer
      - `lockedBalanceAfter` integer
      - `rollingReserveBalanceBefore` integer
      - `rollingReserveBalanceAfter` integer
    - `total` integer

## Other responses

- `400` — 400

---

[API](https://skmtc.net/fincra/apis/awesome-new-api.md) · [All operations](https://skmtc.net/fincra/apis/awesome-new-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fincra/awesome-new-api/revisions/c8215c27b460/schema)