Middle-earth API

Retrieve a ring

GET/rings/{ring_id}

Retrieves a ring by its identifier.

Request

Path parameters

  • ring_id string Required

    The ring's identifier.

Example request

cURL
curl -X GET 'https://api.middle-earth.example/v3/rings/<ring_id>'

Response

The ring.

Body

  • id string Required

    Unique identifier.

  • kind string <RingKind> Required

    The kind of ring.

    Allowed valueselvendwarvenhumanone

  • metal string <Metal> Required

    Metal the ring is made from.

    Allowed valuesgoldsilvermithriliron

  • status string Required

    Where the ring is right now.

    Allowed valuesforgedwornlostdestroyed

  • bearer_id string

    null while the ring is unworn or lost.

  • inscription object <Inscription>

    Text inscribed on the ring.

  • corruption_level integer

    A value from 0 to 100 that grows each day a ring is worn. The One Ring starts at 60.

  • forged_at string date-time

    When the ring was forged.

Example response

application/json

Json
{
  "id": "string",
  "kind": "elven",
  "metal": "gold",
  "status": "forged",
  "bearer_id": "string",
  "inscription": {
    "text": "string",
    "language": "black_speech",
    "visible_when_heated": false
  },
  "corruption_level": 0,
  "forged_at": "2024-01-01T00:00:00Z"
}