curl "https://grail-stack-dev.onrender.com/v1/denominations?country=PK" \
-H "x-api-key: grail_partner_<hex>"
{
"denominations": [
{
"id": "pk_tola_1",
"label": "1 Tola",
"weight_g": 11.664,
"weight_troy_oz": 0.375,
"city": "karachi"
}
]
}
Denominations
List Denominations
Returns the active physical-gold denominations available for redemption in a given country.
GET
/
v1
/
denominations
curl "https://grail-stack-dev.onrender.com/v1/denominations?country=PK" \
-H "x-api-key: grail_partner_<hex>"
{
"denominations": [
{
"id": "pk_tola_1",
"label": "1 Tola",
"weight_g": 11.664,
"weight_troy_oz": 0.375,
"city": "karachi"
}
]
}
Overview
Returns the catalog of physical-gold denominations that users can redeem for, filtered by country. Each entry includes itsid (pass this to Quote Redemption as denomination_id), a human-readable label, weight in grams and troy ounces, and the city of pickup.
Only denominations with active: true are returned.
Headers
string
required
A valid
PARTNER scope key.Query Parameters
string
required
ISO-3166-1 alpha-2 country code (e.g.,
PK, AE, SA).Response
array
Show entry properties
Show entry properties
string
Denomination identifier. Pass to Quote Redemption as
denomination_id. Example: pk_tola_1.string
Human-readable label (e.g.,
"1 Tola").number
Weight in grams.
number
Weight in troy ounces.
string
City of pickup. Redemption quotes require the
city field in the request to match this value (case-insensitive).Errors
| HTTP | error | When |
|---|---|---|
| 400 | invalid_request | country query param is missing |
| 401 | unauthorized | Missing or invalid x-api-key |
curl "https://grail-stack-dev.onrender.com/v1/denominations?country=PK" \
-H "x-api-key: grail_partner_<hex>"
{
"denominations": [
{
"id": "pk_tola_1",
"label": "1 Tola",
"weight_g": 11.664,
"weight_troy_oz": 0.375,
"city": "karachi"
}
]
}