Skip to main content
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 its id (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

​
x-api-key
string
required
A valid PARTNER scope key.

​
Query Parameters

​
country
string
required
ISO-3166-1 alpha-2 country code (e.g., PK, AE, SA).

​
Response

​
denominations
array

​
Errors

HTTPerrorWhen
400invalid_requestcountry query param is missing
401unauthorizedMissing 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"
    }
  ]
}