---
title: "A random milieu"
method: GET
path: "/milieux/random"
tags: ["Reference data"]
---

# A random milieu

`GET /milieux/random`

## Request

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

One entry at random among those matching the same filters as the listing. Loot tables, prompts, "mineral of the day".

## Query parameters

- `realm` string
- `group` string
- `lang` 'en' | 'fr' | 'all'

## Response `200`

One entry.

- object
  - `success` true
  - `data` object: A catalogue entry. Besides the common fields below, the object carries the entry's full data as the encyclopedia stores it (bilingual texts are collapsed to one language unless `lang=all`).
    - `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
    - `license` object
      - `name` string
      - `url` string
      - `attribution` string
  - `links` object
    - `self` string
    - `docs` string

## Other responses

- `404`: Unknown item.

---

[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)