Citations And Evidence

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 exposes first-class evidence_requirement facts when available. These are source-backed legal requirements or recommended proof artifacts, not tenant file uploads.

curl --compressed -sS \
  "$ESHERIA_API_BASE_URL/api/v1/domain-packs/UK-DATA-PROTECTION-PRIVACY/evidence-register" \
  -H "x-api-key: $ESHERIA_API_KEY" | jq

esheria evidence list UK-DATA-PROTECTION-PRIVACY --format json

{
  "tool": "esheria_get_evidence_register",
  "arguments": {
    "pack_id": "UK-DATA-PROTECTION-PRIVACY"
  }
}

Expected shape:

{
  "status": "ok",
  "data": {
    "evidence_register": [
      {
        "evidence_requirement_id": "...",
        "evidence_type": "policy_document",
        "requirement_level": "required",
        "linked_obligation_ids": ["..."],
        "linked_filing_rule_ids": [],
        "obligations": [
          {
            "semantic_obligation_id": "...",
            "citation_ids": ["..."]
          }
        ]
      }
    ]
  },
  "trace_id": "..."
}

Filing Calendar

Filing calendar returns first-class filing rules when the pack has them, with trigger, deadline rule, recurrence, regulator, forms, evidence/proof expected, linked obligations, and citations.

esheria calendar list UK-DATA-PROTECTION-PRIVACY --limit 10 --format json

Penalties And Consequences

Penalty facts are exposed separately from operating obligations so clients can triage consequence and risk without confusing penalties with tasks.

curl --compressed -sS \
  "$ESHERIA_API_BASE_URL/api/v1/domain-packs/UK-DATA-PROTECTION-PRIVACY/penalty-facts?limit=25" \
  -H "x-api-key: $ESHERIA_API_KEY" | jq

Penalty rows include trigger or violation, consequence type, amount or range when source-stated, regulator or enforcer, linked obligations/provisions, and citations.

Legal Review Audit

Use legal review audit to inspect canonical publication and classification metadata:

curl --compressed -sS \
  "$ESHERIA_API_BASE_URL/api/v1/domain-packs/UK-DATA-PROTECTION-PRIVACY/legal-review-audit?limit=25" \
  -H "x-api-key: $ESHERIA_API_KEY" | jq

This endpoint returns fact classification, actionability, promotion state, review decision, blocking reasons, primitive summary, and citations. It is not a tenant workbench endpoint.

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 UK-DATA-PROTECTION-PRIVACY --citation-id CITATION_ID --format json

{
  "tool": "esheria_get_citation_context",
  "arguments": {
    "pack_id": "UK-DATA-PROTECTION-PRIVACY",
    "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.

​Citation Fields

​Evidence Register

​Filing Calendar

​Penalties And Consequences

​Legal Review Audit

​Citation Context

Citation Fields

Evidence Register

Filing Calendar

Penalties And Consequences

Legal Review Audit

Citation Context