Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.esheria.ai/llms.txt

Use this file to discover all available pages before exploring further.

Esheria is citation-first. Applications should preserve citation IDs and quote spans from API responses instead of paraphrasing regulatory facts without source context.

Citation Fields

Common citation-bearing fields include:
  • citation_ids
  • quote_spans
  • authority_ids
  • provision_ids
  • obligation_ids
  • source_asset_id
  • trace_id

Evidence Register

The evidence register groups requirements by evidence type and links them back to obligations and citations.
curl --compressed -sS \
  "$ESHERIA_API_BASE_URL/api/v1/domain-packs/KE-DATA-PROTECTION/evidence-register" \
  -H "x-api-key: $ESHERIA_API_KEY" | jq
Expected shape:
{
  "status": "ok",
  "data": {
    "evidence_register": [
      {
        "evidence_type": "policy_document",
        "obligations": [
          {
            "semantic_obligation_id": "...",
            "citation_ids": ["..."]
          }
        ]
      }
    ]
  },
  "trace_id": "..."
}

Filing Calendar

Filing calendar returns relative deadlines and regulator-reporting items where the pack has those facts.
esheria calendar list KE-DATA-PROTECTION --limit 10 --format json

Citation Context

The CLI and MCP expose citation context by fetching the published pack export and filtering the pack citations client-side.
esheria citations get KE-DATA-PROTECTION --citation-id CITATION_ID --format json
{
  "tool": "esheria_get_citation_context",
  "arguments": {
    "pack_id": "KE-DATA-PROTECTION",
    "citation_id": "CITATION_ID"
  }
}
A direct citation lookup endpoint is a future API improvement. Today the CLI and MCP preserve the same published citation data returned by the pack export.