---
title: "Returns list of settlements"
method: GET
path: "/transactions"
tags: ["Transaction"]
---

# Returns list of settlements

`GET /transactions`

Use this endpoint to retrieve the list of settlements. Transactions can be
filtered using date

## Query parameters

- `start_date` string, date-time
- `end_date` string, date-time
- `page_offset` integer
- `page_size` integer

## Response `200`

List of transactions.

- TransactionObject[]
  - `id` string, uuid — Unique identifier of the transaction
  - `merchantId` string, uuid — Unique Merchant Identifier
  - `type` 'payment' | 'transfer' | 'refund' | 'settlement' — type of transaction
  - `customerId` string, uuid — Identifier of the customer who paid the transaction
  - `customerObject` CustomerObject
    - `id` string, uuid — unique uuid of the customer
    - `name` string — customer's full name
    - `phone` string — customer's mobile phone number.
    - `email` string — the email of the customer
    - `address` string — Full street address, which MAY include house number, street name, Post Office Box, etc
    - `city` string — City or locality component.
    - `postalCode` string — Zip code or postal code component.
    - `country` string, required — ISO3166-1 alpha-2 two letter, uppercase.
    - `locale` string — User locale, language is lower case. Country in upper case
    - `createdAt` string — The date time that record was created in our system.
    - `updatedAt` string — The date time that record was updated in our system.
  - `pspName` 'card' | 'orange_money' | 'wave_money' | 'mtn_money' | 'move_money' | 'free_money' | 'visa_card' | 'mastercard_card' | 'bictorys', required — The PSP, mobile money or card, used for this transaction
  - `paymentMeans` string — means of transaction
  - `paymentChannel` 'Terminal' | 'Online' — Channel used to make the payment
  - `amount` number, double — This is the amount received or paid by the merchant, net of fees.
  - `merchantFees` number, double — The fee paid by the merchant for receiving the payment.
  - `customerFees` number, double — The fee paid by the customer for receiving the payment.
  - `currency` string — The currency associated to the amount. If you don't specify a value, we'll assume 'XOF'
  - `paymentReference` string — payment Reference
  - `merchantReference` string — reference passed by client in the request
  - `orderType` 'flat' | 'order' | 'invoice' | 'paymentlink' — Reference to the type of the payment, invoice, paymentlink, order, flat means the merchant did not create an order or an invoice or a paymentlink prior to call charges API.
  - `orderId` string — unique Id of the order. invoiceId, orderId or paymentlinkId. This value is empty if orderType equals to flat
  - `status` 'succeeded' | 'failed' | 'cancelled' | 'pending' | 'processing' | 'reversed' | 'authorized', required — status of the transaction
  - `originIp` string — IP address of the device that have sent the request
  - `timestamp` string, required — The time and date that the the transaction was recorded in our system. Note that this doesn't describe when payments were executed, only when they were submitted

## Other responses

- `400` — Bad Request
- `401` — The caller is unauthenticated
- `403` — Access rights not sufficient
- `404` — Card not found
- `500` — Internal Server Error.

---

[API](https://skmtc.dev/bictorys/apis/pay.md) · [All operations](https://skmtc.dev/bictorys/apis/pay/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bictorys/pay/revisions/b85cce14340b/schema)