---
title: "GET /api/token-standard/v0/registrars/{registrarParty}/registry/metadata/v1/instruments"
method: GET
path: "/api/token-standard/v0/registrars/{registrarParty}/registry/metadata/v1/instruments"
tags: ["public"]
---

# GET /api/token-standard/v0/registrars/{registrarParty}/registry/metadata/v1/instruments

`GET /api/token-standard/v0/registrars/{registrarParty}/registry/metadata/v1/instruments`

## Request

- Base URL: `https://api.utilities.digitalasset.com`
- URL: `https://api.utilities.digitalasset.com/api/token-standard/v0/registrars/{registrarParty}/registry/metadata/v1/instruments`
- Auth: none required

List all instruments managed by this instrument admin.

## Path parameters

- `registrarParty` string, required

## Query parameters

- `pageSize` integer
- `pageToken` string

## Response `200`

ok

- ListInstrumentsResponse
  - `instruments` Instrument[], required
    - `id` string, required: The unique identifier assigned by the admin to the instrument.
    - `name` string, required: The display name for the instrument recommended by the instrument admin. This is not necessarily unique.
    - `symbol` string, required: The symbol for the instrument recommended by the instrument admin. This is not necessarily unique.
    - `totalSupply` string: Decimal encoded current total supply of the instrument.
    - `totalSupplyAsOf` string, date-time: The timestamp when the total supply was last computed.
    - `decimals` integer, required: The number of decimal places used by the instrument. Must be a number between 0 and 10, as the Daml interfaces represent holding amounts as `Decimal` values, which use 10 decimal places and are precise for 38 digits. Setting this to 0 means that the instrument can only be held in whole units. This number SHOULD be used for display purposes in a wallet to decide how many decimal places to show and accept when displaying or entering amounts.
    - `supportedApis` SupportedApis, required: Map from token standard API name to the minor version of the API supported, e.g., splice-api-token-metadata-v1 -> 1 where the `1` corresponds to the minor version.
  - `nextPageToken` string: The token for the next page of results, to be used as the lastInstrumentId for the next page.

## Other responses

- `404`: not found
- `500`: Internal server error

---

[API](https://skmtc.dev/digital-asset/apis/utilities-api.md) - [All operations](https://skmtc.dev/digital-asset/apis/utilities-api/llms.txt) - [OpenAPI document](https://skmtc.dev/digital-asset/apis/utilities-api/revisions/f494bf184095?raw)