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
Query Parameters
Response
Show entry properties
Show entry properties
Denomination identifier. Pass to Quote Redemption as
denomination_id. Example: pk_tola_1.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"
}
]
}