Skip to main content
GET
/
v1
/
bill
/
products
/
{category}
Browse products by category
curl --request GET \
  --url http://localhost:3000/v1/bill/products/{category} \
  --header 'Authorization: Bearer <token>'
{
  "status": "success",
  "message": "message for success",
  "data": [
    {
      "id": "<string>",
      "name": "<string>",
      "product_code": "<string>",
      "network": "<string>",
      "amount": "<string>",
      "min_amount": "<string>",
      "max_amount": "<string>",
      "currency": "NGN",
      "validity_days": 123,
      "data_size_mb": 123,
      "supports_prepaid": true,
      "supports_postpaid": true,
      "bouquet_code": "<string>",
      "logo_url": "<string>",
      "description": "<string>",
      "featured": true,
      "meta": {}
    }
  ]
}

Authorizations

Authorization
string
header
required

Bearer Authentication

Path Parameters

category
enum<string>
required

Supported bill service categories

Available options:
airtime,
data,
electricity,
cable,
betting,
voucher

Query Parameters

country
string

Country code (defaults to user's profile country)

Example:

"NG"

network
string

Filter by network (data) or cable provider (cable)

Example:

"mtn"

Response

200 - application/json

Products retrieved

General response Values

status
enum<string>
required
Available options:
success,
error
Example:

"success"

message
string
required
Example:

"message for success"

data
object[]