List All Transactions

GET

https://shimi-waas-api-9493532b9281.herokuapp.com/api/v1/transaction/

GET

/api/v1/transaction/

curl -G https://shimi-waas-api-9493532b9281.herokuapp.com/api/v1/transaction/ \
     -H "Authorization: Bearer <token>" \
     -d page=1 \
     -d pageSize=50

{
  "status": "success",
  "data": {
    "data": [
      {
        "id": "cmgc1h9v30012rk5y2m7n4p6q",
        "amount": 50000,
        "type": "CREDIT",
        "status": "SUCCESS",
        "fee": null,
        "narration": "TRF FRM ADEBAYO TUNDE/Rent Oct",
        "sessionId": "000013261004102233441122334455",
        "createdAt": "2026-10-04T10:22:41.118Z",
        "currency": {
          "name": "NGN"
        },
        "customer": {
          "id": "cmg8x2k4p0001qz7h3n9d5v2a",
          "firstName": "Chiamaka",
          "lastName": "Okonkwo"
        }
      },
      {
        "id": "cmgc0f4w80009rk5ya8b3c1de",
        "amount": 12500,
        "type": "CREDIT",
        "status": "SUCCESS",
        "fee": null,
        "narration": "INWARDS",
        "sessionId": "000016261003181510998877665544",
        "createdAt": "2026-10-03T18:15:09.604Z",
        "currency": {
          "name": "NGN"
        },
        "customer": {
          "id": "cmg8y5t1m0004qz7hk2l8w3rb",
          "firstName": "Tunde",
          "lastName": "Adebayo"
        }
      }
    ],
    "meta": {
      "page": 1,
      "pageSize": 50,
      "totalItems": 2,
      "totalPages": 1,
      "hasNextPage": false,
      "hasPrevPage": false,
      "nextPage": null,
      "prevPage": null,
      "from": 1,
      "to": 2
    }
  }
}

List all customer-account transactions across your company.

Query parameters

Field	Type	Required	Notes
`page`	integer	no	Default 1
`pageSize`	integer	no	Default 50, max 100

Behaviour notes

Lists inbound credits to your customers’ dedicated accounts, newest first.
The list is nested at data.data, with pagination in data.meta.
A page past the last one returns an empty data.data with accurate meta.
type is CREDIT and status is SUCCESS for webhook-credited transfers. fee is usually null.

Authentication

AuthorizationBearer

Access token from Generate Access Token (valid 15 minutes).

Query parameters

pagestringOptional

pageSizestringOptional

Response

statusstringOptional

dataobjectOptional

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error