Skip to main content
Fetch the available items (packages or denominations) for a specific biller. These are the purchasable options your users can select from.

Usage

Pass the biller_id as a path parameter and the category as a query parameter.
curl https://api.payvessel.com/api/v1/biller-reseller/billers/{biller_id}/items?category=betting \
  -H "api-key: YOUR_API_KEY" \
  -H "api-secret: YOUR_SECRET_KEY"

Response fields

Each item includes:
FieldTypeDescription
biller_idstringThe parent biller’s ID
item_idstringUnique item identifier (used when creating an order)
item_namestringDisplay name of the item
amountinteger or nullFixed price (null if variable)
min_amountinteger or nullMinimum amount for variable-price items
max_amountinteger or nullMaximum amount for variable-price items
is_fix_amountinteger or null1 if the item has a fixed price
statusinteger or nullItem availability status
ext_infoobject or nullExtra details (validity period, data size, description)

ext_info object

FieldTypeDescription
validity_dateinteger or nullValidity in days
item_sizestring or nullData size (e.g. “1GB”, “5GB”)
item_descriptionobject or nullAdditional description from the provider

Next step

Use the item_id when creating an order.

API Reference

Full request/response details and Try it