TNM–API

Overview

TNM–API provides read-only access to The New Mithraeum corpus. All responses are JSON encoded in UTF-8.

Base URL: https://www.mithraeum.eu

Authentication

All endpoints require a personal API key. Send it as a Bearer token or as a query parameter:

Authorization: Bearer <your-api-key>
# or
GET /api/monuments?search=cautes&apikey=<your-api-key>

You can generate your key in your member profile. If you are not a member yet, create a free account.

Rate limiting

Requests are limited to 60 per minute per IP address. Exceeding this limit returns a 429 response. Please cache results on your side and avoid polling.

Terms of use

The API is free for non-commercial, academic and personal use. Data must be attributed to The New Mithraeum with a link to https://www.mithraeum.eu. Redistribution of the full dataset is not permitted.

Monuments

Get a single monument

Parameter	Type	Description
id	integer	Monument numeric ID (e.g. 130)

{
  "id": 130,
  "name": "Cautes from Newcastle",
  "subtitle": "Torchbearer statuette",
  "url": "https://www.mithraeum.eu/monument/130",
  "type": "Sculpture",
  "subject": "Cautes",
  "period": "2nd century AD",
  "material": "Sandstone",
  "location": {
    "find_spot": { "name": "Pons Aelius", "city": "Newcastle", "country": "United Kingdom" },
    "current": { "name": "Great North Museum", "city": "Newcastle", "country": "United Kingdom" },
    "coordinates": { "lat": 54.978, "lon": -1.614 }
  },
  "dimensions": { "h": 45.0, "w": 20.0 },
  "references": { "cimrm": "273c", "rib": "1398" },
  "image": "https://www.mithraeum.eu/album/monumenta/cautes-newcastle.jpg"
}

List monuments

At least one filter is required.

Parameter	Type	Description
country	string	Filter by country of origin — ISO 3166-1 alpha-2 code (e.g. DE, IT, GB)
type	string	Filter by monument type (e.g. Sculpture, Inscription)
search	string	Search by name
limit	integer	Results per page, max 50 (default: 50)
page	integer	Page number (default: 1)

{
  "total": 312,
  "page": 1,
  "limit": 50,
  "results": [
    {
      "id": 26,
      "name": "Mithraeum of Carrawburgh",
      "url": "https://www.mithraeum.eu/monument/26",
      "type": "Mithraeum",
      "subject": "Mithraeum",
      "period": "3rd century AD",
      "location": { "name": "Brocolitia", "city": "Carrawburgh", "country": "United Kingdom" },
      "image": "https://www.mithraeum.eu/album/monumenta/carrawburgh.jpg"
    }
  ]
}

Persons

Get a single person

Parameter	Type	Description
id	integer	Person numeric ID

{
  "id": 172,
  "name": "Antiochus I of Commagene",
  "url": "https://www.mithraeum.eu/person/172",
  "title": "King",
  "grade": "Pater",
  "period": "1st century BC",
  "places": [
    {
      "type": "activity",
      "name": "Samsat",
      "city": "Adıyaman",
      "lat": 37.574,
      "lon": 38.486,
      "monument": {
        "id": 594,
        "name": "Tablet of Antiochus I from Samsat",
        "url": "https://www.mithraeum.eu/monument/594"
      }
    }
  ]
}

List persons

At least one filter is required. Grades: 1 Corax · 2 Nymphus · 3 Miles · 4 Leo · 5 Perses · 6 Heliodromus · 7 Pater.

Parameter	Type	Description
grade	integer	Mithraic grade (1–7)
search	string	Search by name
period	string	Filter by period (e.g. 2nd century AD)
limit	integer	Results per page, max 50 (default: 50)
page	integer	Page number (default: 1)

Places

Get a single place

The id can be the place slug (e.g. vindolanda) or its numeric ID.

{
  "id": "brocolitia",
  "name": "Brocolitia",
  "alt_name": "Carrawburgh",
  "url": "https://www.mithraeum.eu/place/brocolitia",
  "location": {
    "province": "Britannia inferior",
    "city": "Carrawburgh",
    "country": "United Kingdom",
    "lat": 55.021,
    "lon": -2.364
  },
  "wikidata": "Q1000752",
  "monuments": [
    {
      "id": 26,
      "name": "Mithraeum of Carrawburgh",
      "url": "https://www.mithraeum.eu/monument/26"
    }
  ]
}

List places

Parameter	Type	Description
country	string	Filter by country — ISO 3166-1 alpha-2 code (e.g. FR, IT, GB)
search	string	Search by ancient or modern name
limit	integer	Results per page, max 50 (default: 50)
page	integer	Page number (default: 1)

Bibliography

Get a single book

The id is the book slug visible in the URL (e.g. corpus-inscriptionum-et-monumentorum-religionis-mithriacae_19561960).

{
  "id": "corpus-inscriptionum-et-monumentorum-religionis-mithriacae_19561960",
  "title": "Corpus Inscriptionum et Monumentorum Religionis Mithriacae",
  "url": "https://www.mithraeum.eu/book/corpus-inscriptionum-et-monumentorum-religionis-mithriacae_19561960",
  "authors": ["Maarten J. Vermaseren"],
  "year": "1956",
  "publisher": "Martinus Nijhoff",
  "isbn": null,
  "language": "English",
  "monuments": [
    {
      "id": 130,
      "name": "Cautes from Newcastle",
      "url": "https://www.mithraeum.eu/monument/130"
    }
  ]
}

List books

Parameter	Type	Description
search	string	Search by title or summary
year	integer	Filter by publication year
limit	integer	Results per page, max 50 (default: 50)
page	integer	Page number (default: 1)

Errors

Code	Meaning
400	Bad request — missing or invalid parameter
401	Unauthorized — missing or invalid API key
404	Not found — the requested resource does not exist
429	Too many requests — rate limit exceeded (60/min)
500	Server error

All error responses have the same shape:

{ "error": "Description of the problem." }

Attribution

When using data from this API, please cite The New Mithraeum and link to the canonical URL of each resource:

Data courtesy of The New Mithraeum <https://www.mithraeum.eu>