Skip to main content

OTC Transactions - by Value

Over-the-counter (OTC) transaction value processed through mobile-money agents.

GET/3.0/alternate/otc-transactions-value

Request​

Authentication​

  • Type: Bearer Token
  • Required: Yes

Parameters​

This endpoint does not accept any query parameters.

Response​

Success Response (200)​

{
  "status":"ok",
  "message": "",
  "data":[
    {
      "period": "Nov 2024",
      "total": 9876543210,
      "txn_types": [
        {
          "key": "ptop",
          "value": 5432167890
        },
        {
          "key": "pension_otc",
          "value": 4444375320
        },
        {
          "key": "utility_bills",
          "value": 987239847
        }
      ]
    }
  ]
}

Response Fields​

FieldTypeDescription
periodstringPeriod of the data point (e.g., "Nov 2024")
totalnumberTotal value of OTC transactions in local currency (e.g., 9876543210)
txn_typesarrayList of transaction types with their values View

Txn Types Object​

FieldTypeDescription
keystringTransaction type key (e.g., "ptop", "pension_otc", "utility_bills")
valuenumberValue of the transaction type in local currency

Error Responses​

For detailed Common Error responses, see the Error Handling.

Examples​

GET OTC Transactions - by Value​

curl -X GET "https://csapis.com/3.0/alternate/otc-transactions-value" -H "Authorization: Bearer YOUR_API_TOKEN"

Use Cases​

  • Data analysis
  • Dashboard / metrics