Skip to main content
Fetch all available denominations (values) for a gift card product. This returns the specific card values your users can purchase, along with USD and NGN pricing.

​
Usage

curl https://api.payvessel.com/api/v1/gift-cards/products/{operator_id}/denominations \
  -H "api-key: YOUR_API_KEY" \
  -H "api-secret: YOUR_SECRET_KEY"

​
Path parameters

ParameterTypeRequiredDescription
operator_idstringYesThe product/operator ID from List Products

​
Response fields

The data object is a map of denomination IDs to denomination objects:
FieldTypeDescription
idstringDenomination ID (used as product_id when creating an order)
namestringDisplay name (e.g. “$25 Amazon Gift Card”)
priceTypestring or nullPricing type (e.g. “FIXED”, “RANGE”)
usdnumber or nullPrice in USD
ngnnumber or nullPrice in NGN
operatorIdstring or nullParent operator ID
countrystring or nullCountry code
imagestring or nullCard image URL

​
Next step

Use the denomination id as the product_id when purchasing a gift card.

API Reference

Full request/response details and Try it