USSD billing summary

GET 
https://core-prod.malipopay.co.tz/api/v1/ussd/billing/summary

Returns a billing summary grouped by operator and period.

Request

Query Parameters

env string

Environment filter (TEST or PROD)

year integer

Year filter

month integer

Month filter (1-12)

operator string

Operator filter

Responses

200

Billing summary returned

application/json

Schema

Schema

successbooleanrequired
Example: true
codeintegerrequired
MALIPOPAY-specific status code (see error codes reference)
Example: 800
messagestringrequired
Example: Operation completed successfully
data object

Endpoint-specific payload

property name*any

Endpoint-specific payload

Example (auto)

{
  "success": true,
  "code": 800,
  "message": "Operation completed successfully",
  "data": {}
}

500

Internal server error

application/json

Schema

Schema

successbooleanrequired
Example: false
codeintegerrequired
MALIPOPAY-specific error code
Example: 886
messagestringrequired
Example: Operation failed
detailsstring
Human-readable error details
Example: Invalid apiToken

Example (auto)

{
  "success": false,
  "code": 886,
  "message": "Operation failed",
  "details": "Invalid apiToken"
}

Authorization: apiToken

name: apiTokentype: apiKeyin: headerdescription: Project API key. Get yours from the Malipopay dashboard under Settings → API Keys.

• curl
• python
• nodejs
• php
• java
• go

• CURL

curl -L 'https://core-prod.malipopay.co.tz/api/v1/ussd/billing/summary' \
-H 'Accept: application/json' \
-H 'apiToken: <apiToken>'

Request

Base URL

https://core-prod.malipopay.co.tz

Auth

apiToken

Parameters

env — query

year — query

month — query

operator — query

Response

Click the Send API Request button above and see the response here!