Skip to main content

Market Share by Agents

Operator market share measured by number of agents.

GET/3.0/alternate/mobile-money-market-share-agents

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",
            "operators":[
                {
                    "key": "telenor",
                    "value": 0.3
                },
                {
                    "key": "jazz",
                    "value": 0.4
                },
                {
                    "key": "ubl",
                    "value": 0.075
                },
                {
                    "key": "others",
                    "value": 0.05
                }
            ]
        }
    ]
}

Response Fields​

FieldTypeDescription
periodstringPeriod of the data point (e.g., "Nov 2024")
operatorsarrayList of operators with their market share by agents View

Operators Object​

FieldTypeDescription
keystringOperator key (e.g., "telenor", "jazz", "ubl", "others")
valuefloatMarket share by agents (e.g., 0.3 for 30%)

Error Responses​

For detailed Common Error responses, see the Error Handling.

Examples​

GET Market Share by Agents​

curl -X GET "https://csapis.com/3.0/alternate/mobile-money-market-share-agents" -H "Authorization: Bearer YOUR_API_TOKEN"

Use Cases​

  • Data analysis
  • Dashboard / metrics