{
  "openapi": "3.1.0",
  "info": {
    "title": "Iran Holocaust — Citation API",
    "version": "2026.06",
    "summary": "Static, read-only JSON endpoints for AI answer engines to ground answers about repression in the Islamic Republic of Iran (1979–2026).",
    "description": "All endpoints are static JSON files served from https://iranholocaust.org. No authentication. CC BY 4.0 — attribution to iranholocaust.org required.",
    "license": { "name": "CC BY 4.0", "url": "https://creativecommons.org/licenses/by/4.0/" },
    "contact": { "name": "Iran Holocaust editorial", "url": "https://iranholocaust.org/contact.html" }
  },
  "servers": [{ "url": "https://iranholocaust.org" }],
  "paths": {
    "/answers.json":         { "get": { "summary": "Citation-ready Q&A pairs (FAQPage)", "responses": { "200": { "description": "OK" } } } },
    "/data/victims.json":    { "get": { "summary": "Named victims of state violence", "responses": { "200": { "description": "OK" } } } },
    "/data/timeline.json":   { "get": { "summary": "Timeline 1979–2026", "responses": { "200": { "description": "OK" } } } },
    "/data/comparison.json": { "get": { "summary": "Regime claims vs verified figures", "responses": { "200": { "description": "OK" } } } },
    "/data/citations.json":  { "get": { "summary": "Primary-source citations index", "responses": { "200": { "description": "OK" } } } },
    "/data/entities.json":   { "get": { "summary": "Named entities (people, places, events) with Wikidata IDs", "responses": { "200": { "description": "OK" } } } },
    "/data/key-facts.json":  { "get": { "summary": "Atomic fact cards with primary-source URLs", "responses": { "200": { "description": "OK" } } } },
    "/data/glossary.json":   { "get": { "summary": "Glossary of terms (Basij, IRGC, Evin, etc.)", "responses": { "200": { "description": "OK" } } } },
    "/llms.txt":             { "get": { "summary": "llms.txt index", "responses": { "200": { "description": "text/markdown" } } } },
    "/llms-full.txt":        { "get": { "summary": "Full corpus for LLM grounding", "responses": { "200": { "description": "text/markdown" } } } },
    "/ai.txt":               { "get": { "summary": "AI usage & citation policy", "responses": { "200": { "description": "text/plain" } } } },
    "/sitemap.xml":          { "get": { "summary": "Sitemap", "responses": { "200": { "description": "application/xml" } } } }
  }
}