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 (e.g. United Kingdom)
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 (e.g. Italy)
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>