---
title: "List gems"
method: GET
path: "/gems"
tags: ["Reference data"]
---

# List gems

`GET /gems`

## Request

- Base URL: `https://michaelghelfistudios.com/api/v1`
- URL: `https://michaelghelfistudios.com/api/v1/gems`
- Auth: none declared

Socketable gems of the Crafting Table: colour, rarity, effect at each level. 58 entries.

## Query parameters

- `color` string
- `rarity` string
- `temporary` boolean
- `q` string
- `lang` 'en' | 'fr' | 'all'
- `limit` integer
- `offset` integer

## Response `200`

A page of gems.

- object
  - `success` true
  - `data` object[]
    - `kind` 'metal' | 'mineral' | 'ingredient' | 'potion' | 'gem' | 'milieu' | 'animal' | 'plant' | 'monster' | 'hearth_page' | 'passage_page' | 'bearer_page'
    - `id` string: Stable identifier, safe in URLs (`iron`, `rose_quartz`).
    - `name` union: Display name in the requested language.
      - string
      - object
    - `url` string, uri: Canonical page on michaelghelfistudios.com — the page to link.
    - `embed_url` string, uri: Iframe-able card for this entry (see Embeds).
    - `image_url` string, uri: A picture of the entry when one exists (rendered specimens of the fantasy minerals).
  - `meta` object
    - `version` 'v1'
    - `lang` string
    - `total` integer: Items matching the query, ignoring pagination.
    - `limit` integer
    - `offset` integer
    - `license` object
      - `name` string
      - `url` string
      - `attribution` string
  - `links` object
    - `self` string
    - `docs` string

---

[API](https://skmtc.dev/michaelghelfistudios/apis/mgs-toolbox-public-api.md) · [All operations](https://skmtc.dev/michaelghelfistudios/apis/mgs-toolbox-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/michaelghelfistudios/apis/mgs-toolbox-public-api/revisions/20d2b0932478?raw)