---
title: "List transactions"
method: GET
path: "/v1/transactions/history"
tags: ["Transactions"]
---

# List transactions

`GET /v1/transactions/history`

## Query parameters

- `page` integer
- `limit` integer
- `order` 'ASC' | 'DESC'
- `sort` string
- `query` string
- `currency` 'NGN' | 'KES' | 'ZAR' | 'GHS' | 'XOF' | 'USD'
- `type` 'payouts' | 'paymentLinks'

## Response `200`

Transaction list.

- PaginatedTransactionsResponse
  - `status` boolean
  - `message` string
  - `code` integer
  - `data` object
    - `page` integer
    - `limit` integer
    - `total` integer
    - `pageCount` integer
    - `hasPreviousPage` boolean
    - `hasNextPage` boolean
    - `transactions` PublicTransaction[]
      - `id` string
      - `reference` string
      - `status` 'PENDING' | 'SUCCESS' | 'IN_REVIEW' | 'FAILED' | 'COLLECTED'
      - `type` 'CR' | 'DR'
      - `paymentType` string
      - `currency` string
      - `amount` number
      - `grossAmount` number
      - `customerPaidAmount` number
      - `netAmount` number
      - `creditedAmount` number
      - `feeBearer` 'MERCHANT' | 'CUSTOMER'
      - `fees` object
        - `total` number
        - `processorFee` number
        - `vat` number
        - `platformFee` number
        - `stampDuty` number
        - `others` object
      - `settlement` object
        - `amount` number
        - `currency` string
      - `customer` object
      - `createdAt` string, date-time
      - `updatedAt` string, date-time

---

[API](https://skmtc.net/kyshi/apis/kyshi-mor-public-api.md) · [All operations](https://skmtc.net/kyshi/apis/kyshi-mor-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kyshi/kyshi-mor-public-api/revisions/3c46fabe8df7/schema)