> ## 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.

# Citations And Evidence

> Keep source IDs, quote spans, evidence requirements, and trace IDs attached to every regulatory answer.

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.

<CodeGroup>
  ```bash curl theme={null}
  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
  ```

  ```bash CLI theme={null}
  esheria evidence list UK-DATA-PROTECTION-PRIVACY --format json
  ```

  ```json MCP theme={null}
  {
    "tool": "esheria_get_evidence_register",
    "arguments": {
      "pack_id": "UK-DATA-PROTECTION-PRIVACY"
    }
  }
  ```
</CodeGroup>

Expected shape:

```json theme={null}
{
  "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.

```bash theme={null}
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.

```bash theme={null}
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:

```bash theme={null}
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.

```bash theme={null}
esheria citations get UK-DATA-PROTECTION-PRIVACY --citation-id CITATION_ID --format json
```

```json theme={null}
{
  "tool": "esheria_get_citation_context",
  "arguments": {
    "pack_id": "UK-DATA-PROTECTION-PRIVACY",
    "citation_id": "CITATION_ID"
  }
}
```

<Note>
  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.
</Note>