Reference

API documentation

All endpoints are static JSON files. No authentication, no rate limiting, no SDK required. Fetch them with anything that speaks HTTP.

Endpoints

Path	Returns	Sample
/dynasties/<SLUG>.json	One dynastie record by slug.	/dynasties/example.json
/index.json	Compact list of every slug. Use for autocomplete.	/index.json
/all.json	Bulk data: all.json.	/all.json
/timeline.json	Bulk data: timeline.json.	/timeline.json
/eras.json	Bulk data: eras.json.	/eras.json

Base URL: https://dynasties.oriz.in · also at https://cdn.jsdelivr.net/gh/oriz-org/dynasties-api@main

Sample record

{
  "slug": "mauryan",
  "name": "Mauryan Empire",
  "alt_names": [
    "Maurya Dynasty"
  ],
  "period": {
    "start": -322,
    "end": -185,
    "start_era": "BCE",
    "end_era": "BCE"
  },
  "region": "South Asia (most of subcontinent)",
  "capitals": [
    "Pataliputra"
  ],
  "rulers": [
    {
      "name": "Chandragupta Maurya",
      "reign_start": -322,
      "reign_end": -298,
      "notes": "Founder; tutored by Chanakya/Kautilya"
    },
    {
      "name": "Ashoka the Great",
      "reign_start": -268,
      "reign_end": -232,
      "notes": "Embraced Buddhism after Kalinga War; dhamma edicts"
    }
  ],
  "religion": "Hinduism, Buddhism, Jainism (pluralistic; Ashoka patronised Buddhism)",
  "predecessor": "nanda",
  "successor": "shunga",
  "notable_achievements": [
    "First pan-Indian empire",
    "Ashoka's rock and pillar edicts",
    "Spread of Buddhism to Sri Lanka and Central Asia"
  ],
  "notes": ""
}

Errors

The only possible error is 404 — unknown slug. There is no authentication, no rate limit, and no quota, so 401/403/429 cannot occur. CORS is wide open on both origins.

License

Code: MIT. Data: CC BY-SA 4.0 (where derived from Wikipedia / public sources).