List Bill Providers

GET

http://localhost:8080/api/v3/bill-providers

GET

/api/v3/bill-providers

curl -G http://localhost:8080/api/v3/bill-providers \
     -H "Authorization: Bearer {{accessToken}}" \
     -d billProviderName=Kenya \
     -d category=ELECTRICITY \
     -d isActive=true \
     -d page=0 \
     -d size=20 \
     -d status=APPROVED

200Wallet_listBillProviders_example

{
  "code": 200,
  "message": "Bill providers retrieved successfully",
  "data": {
    "content": [
      {
        "id": "5c6d7e8f-9a0b-4c1d-8e2f-3a4b5c6d7e8f",
        "name": "Kenya Power",
        "category": "ELECTRICITY",
        "businessNumber": "888880",
        "logoUrl": "https://cdn.sare.africa/bill-providers/kplc.png",
        "mediumLogoUrl": "https://cdn.sare.africa/bill-providers/kplc-medium.png",
        "thumbnailLogoUrl": "https://cdn.sare.africa/bill-providers/kplc-thumb.png",
        "accountType": "METER_NO",
        "shortDescription": "Postpaid electricity token top-up",
        "approvalStatus": "PENDING",
        "isActive": false,
        "createdAt": "2026-09-17T10:00:00Z",
        "updatedAt": "2026-09-17T10:00:00Z"
      }
    ],
    "pageNumber": 1,
    "size": 20,
    "totalElements": 1,
    "totalPages": 1,
    "isLastPage": true
  }
}

Query parameters

billProviderNamestringOptional

isActivebooleanOptional

categorystringOptional

statusstringOptional

pageintegerOptional

sizeintegerOptional

Response

200 OK

codeintegerOptional

messagestringOptional

dataobjectOptional

Headers

Query parameters

Response