API product catalogTreasury, Cash Management & FX Settlement

List top-up requests

Treasury, Cash Management & FX Settlement

GET

/topup

Sandbox availablelistTopup

Returns all master wallet top-up requests and their approval status.

Parameters

This endpoint has no path or query parameters.

Headers

AuthorizationstringRequired

Bearer sk_sandbox_<your_key> for sandbox requests.

Response fields

topupsobject[]

topups[].idstring

topups[].amountnumber

topups[].paymentReferencestring

topups[].statuspending | approved | rejected

topups[].createdAtstring

Response codes

200Top-up request list.

Sandbox playground

Read-only sandbox request

Sandbox API keyYour key stays in this page’s memory.

https://mystocks.africa/api/sandbox/v1/partner/topup

Open in API Tester API Reference

Response schema

{
  "type": "object",
  "properties": {
    "topups": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "amount": {
            "type": "number"
          },
          "paymentReference": {
            "type": "string"
          },
          "status": {
            "type": "string",
            "enum": [
              "pending",
              "approved",
              "rejected"
            ]
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          }
        }
      }
    }
  }
}

curl -X GET 'https://mystocks.africa/api/sandbox/v1/partner/topup' \
  -H "Authorization: Bearer $MYSTOCKS_SANDBOX_API_KEY"

POST /payout

POST /topup