List 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"
    }
  ]
}

GET

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

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

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"
    }
  ]
}

Get User Quote Buy

API Reference

General

Authentication

Partner

Users

Denominations

Trades

Redemptions

List Denominations

Overview

Headers

Query Parameters

Response

Errors

​Overview

​Headers

​Query Parameters

​Response

​Errors

Overview

Headers

Query Parameters

Response

Errors