> ## Documentation Index
> Fetch the complete documentation index at: https://docs.grail.oro.finance/llms.txt
> Use this file to discover all available pages before exploring further.

# List Denominations

> Returns the active physical-gold denominations available for redemption in a given country.

## 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](/api-reference/redemptions/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

<ParamField header="x-api-key" type="string" required>
  A valid `PARTNER` scope key.
</ParamField>

## Query Parameters

<ParamField query="country" type="string" required>
  ISO-3166-1 alpha-2 country code (e.g., `PK`, `AE`, `SA`).
</ParamField>

## Response

<ResponseField name="denominations" type="array">
  <Expandable title="entry properties">
    <ResponseField name="id" type="string">
      Denomination identifier. Pass to [Quote Redemption](/api-reference/redemptions/quote-redemption) as `denomination_id`. Example: `pk_tola_1`.
    </ResponseField>

    <ResponseField name="label" type="string">
      Human-readable label (e.g., `"1 Tola"`).
    </ResponseField>

    <ResponseField name="weight_g" type="number">
      Weight in grams.
    </ResponseField>

    <ResponseField name="weight_troy_oz" type="number">
      Weight in troy ounces.
    </ResponseField>

    <ResponseField name="city" type="string">
      City of pickup. Redemption quotes require the `city` field in the request to match this value (case-insensitive).
    </ResponseField>
  </Expandable>
</ResponseField>

## Errors

| HTTP | `error`           | When                             |
| ---- | ----------------- | -------------------------------- |
| 400  | `invalid_request` | `country` query param is missing |
| 401  | `unauthorized`    | Missing or invalid `x-api-key`   |

<RequestExample>
  ```bash cURL theme={null}
  curl "https://grail-stack-dev.onrender.com/v1/denominations?country=PK" \
    -H "x-api-key: grail_partner_<hex>"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "denominations": [
      {
        "id": "pk_tola_1",
        "label": "1 Tola",
        "weight_g": 11.664,
        "weight_troy_oz": 0.375,
        "city": "karachi"
      }
    ]
  }
  ```
</ResponseExample>