Get Biller Items

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.

curl https://api.payvessel.com/vaas/api/v1/biller-reseller/billers/{biller_id}/items \
  -H "api-key: YOUR_API_KEY" \
  -H "api-secret: YOUR_SECRET_KEY"

Response fields

Each item includes:

Field	Type	Description
`biller_id`	string	The parent biller’s ID
`item_id`	string	Unique item identifier (used when creating an order)
`item_name`	string	Display name of the item
`amount`	integer or null	Fixed price (null if variable)
`min_amount`	integer or null	Minimum amount for variable-price items
`max_amount`	integer or null	Maximum amount for variable-price items
`is_fixed_amount`	boolean or null	`true` if the item has a fixed price
`ext_info`	object or null	Extra details (validity period, data size, description)

ext_info object

Field	Type	Description
`validity_date`	integer or null	Validity in days
`item_size`	string or null	Data size (e.g. “1GB”, “5GB”)
`item_description`	object or null	Additional description from the provider

Next step

Use the item_id when creating an order.

API Reference

Full request/response details and Try it

Getting started

Use cases

API Basics

Accept Payment

Transfers

Wallets

Virtual Accounts

Issuing

Identity Verification

Value Added Services

Webhook

Usage

Response fields

ext_info object

Next step

API Reference

​Usage

​Response fields

​ext_info object

​Next step

API Reference

Usage

Response fields

ext_info object

Next step