List transactions

GET

transactions

List transactions

curl --request GET \
  --url https://serviceapi.sarafa.ss/v3/transactions \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://serviceapi.sarafa.ss/v3/transactions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "status": "success",
  "data": [
    {
      "reference": "<string>",
      "total_amount": 123,
      "fee": 123,
      "product": "collect_mobile",
      "description": "<string>",
      "direction": "add",
      "amount": 123,
      "currency": "<string>",
      "usd_amount": 123,
      "counterparty": {
        "name": "<string>",
        "identifier": "<string>"
      },
      "phone_number": "<string>",
      "account_number": "<string>",
      "status": "pending",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "completed_at": "2023-11-07T05:31:56Z",
      "external_id": "<string>"
    }
  ],
  "meta": {
    "limit": 123,
    "offset": 123
  }
}

Authorizations

x-api-key

string

header

required

Merchant API secret.

Headers

environment

enum<string>

default:production

Target environment. Defaults to production when omitted and must match the API key environment.

Available options:

production,

sandbox

Query Parameters

limit

integer

default:50

Number of transactions to return.

Required range: 0 <= x <= 100

offset

integer

default:0

Number of transactions to skip.

Required range: x >= 0

Response

Transactions.

status

enum<string>

required

Available options:

success

data

object[]

required

Show child attributes

meta

object

required

Show child attributes

Last modified on July 22, 2026

List transactions

curl --request GET \
  --url https://serviceapi.sarafa.ss/v3/transactions \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://serviceapi.sarafa.ss/v3/transactions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "status": "success",
  "data": [
    {
      "reference": "<string>",
      "total_amount": 123,
      "fee": 123,
      "product": "collect_mobile",
      "description": "<string>",
      "direction": "add",
      "amount": 123,
      "currency": "<string>",
      "usd_amount": 123,
      "counterparty": {
        "name": "<string>",
        "identifier": "<string>"
      },
      "phone_number": "<string>",
      "account_number": "<string>",
      "status": "pending",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "completed_at": "2023-11-07T05:31:56Z",
      "external_id": "<string>"
    }
  ],
  "meta": {
    "limit": 123,
    "offset": 123
  }
}

Get started

How to use the API

Endpoint playground

Authorizations

Headers

Query Parameters

Response