# Esheria

> Developer documentation for Esheria's citation-backed API, CLI, and MCP server.

## Docs

- [MCP](https://docs.esheria.ai/agent-tools/mcp.md): Connect Esheria's regulatory tools to Claude, Codex, Cursor, or an internal agent host.
- [Create a data API token](https://docs.esheria.ai/api-reference/api-tokens/create-a-data-api-token.md)
- [List workspace API tokens](https://docs.esheria.ai/api-reference/api-tokens/list-workspace-api-tokens.md)
- [Revoke an API token](https://docs.esheria.ai/api-reference/api-tokens/revoke-an-api-token.md)
- [Approve Oauth Authorization Request](https://docs.esheria.ai/api-reference/approve-oauth-authorization-request.md)
- [Cancel the current workspace subscription](https://docs.esheria.ai/api-reference/billing/cancel-the-current-workspace-subscription.md)
- [Create a Stripe Checkout session for credits or subscription](https://docs.esheria.ai/api-reference/billing/create-a-stripe-checkout-session-for-credits-or-subscription.md)
- [Get the current workspace subscription](https://docs.esheria.ai/api-reference/billing/get-the-current-workspace-subscription.md)
- [Get workspace credit balance](https://docs.esheria.ai/api-reference/billing/get-workspace-credit-balance.md)
- [List available billing plans](https://docs.esheria.ai/api-reference/billing/list-available-billing-plans.md)
- [List metered API usage](https://docs.esheria.ai/api-reference/billing/list-metered-api-usage.md)
- [Create a workspace-scoped customer regulatory profile](https://docs.esheria.ai/api-reference/customer-applicability-api/create-a-workspace-scoped-customer-regulatory-profile.md)
- [Inspect a workspace-scoped customer regulatory profile](https://docs.esheria.ai/api-reference/customer-applicability-api/inspect-a-workspace-scoped-customer-regulatory-profile.md)
- [List persisted customer-specific applicability runs](https://docs.esheria.ai/api-reference/customer-applicability-api/list-persisted-customer-specific-applicability-runs.md)
- [List workspace customer change impacts](https://docs.esheria.ai/api-reference/customer-applicability-api/list-workspace-customer-change-impacts.md)
- [List workspace customer obligation instances that reference published facts](https://docs.esheria.ai/api-reference/customer-applicability-api/list-workspace-customer-obligation-instances-that-reference-published-facts.md)
- [List workspace-scoped customer regulatory profiles](https://docs.esheria.ai/api-reference/customer-applicability-api/list-workspace-scoped-customer-regulatory-profiles.md)
- [Preview customer applicability and change impacts without storing customer state](https://docs.esheria.ai/api-reference/customer-applicability-api/preview-customer-applicability-and-change-impacts-without-storing-customer-state.md)
- [Recompute customer impacts from pack change events](https://docs.esheria.ai/api-reference/customer-applicability-api/recompute-customer-impacts-from-pack-change-events.md)
- [Run and persist customer-specific applicability against locked pack versions](https://docs.esheria.ai/api-reference/customer-applicability-api/run-and-persist-customer-specific-applicability-against-locked-pack-versions.md)
- [Update tenant-owned lifecycle state for a customer change impact](https://docs.esheria.ai/api-reference/customer-applicability-api/update-tenant-owned-lifecycle-state-for-a-customer-change-impact.md)
- [Update tenant-owned lifecycle state for a customer obligation instance](https://docs.esheria.ai/api-reference/customer-applicability-api/update-tenant-owned-lifecycle-state-for-a-customer-obligation-instance.md)
- [Deny Oauth Authorization Request](https://docs.esheria.ai/api-reference/deny-oauth-authorization-request.md)
- [Get Oauth Authorization Request](https://docs.esheria.ai/api-reference/get-oauth-authorization-request.md)
- [Oauth Authorization Server Metadata](https://docs.esheria.ai/api-reference/oauth-authorization-server-metadata.md)
- [Oauth Authorize](https://docs.esheria.ai/api-reference/oauth-authorize.md)
- [Oauth Introspect](https://docs.esheria.ai/api-reference/oauth-introspect.md)
- [Oauth Protected Resource Metadata](https://docs.esheria.ai/api-reference/oauth-protected-resource-metadata.md)
- [Oauth Register](https://docs.esheria.ai/api-reference/oauth-register.md)
- [Oauth Revoke](https://docs.esheria.ai/api-reference/oauth-revoke.md)
- [Oauth Token](https://docs.esheria.ai/api-reference/oauth-token.md)
- [Healthz](https://docs.esheria.ai/api-reference/operations/healthz.md)
- [Metrics](https://docs.esheria.ai/api-reference/operations/metrics.md)
- [Readyz](https://docs.esheria.ai/api-reference/operations/readyz.md)
- [Query published regulatory relationship facts across packs](https://docs.esheria.ai/api-reference/regulatory-graph-api/query-published-regulatory-relationship-facts-across-packs.md)
- [Rebuild published regulatory graph projections from serving facts](https://docs.esheria.ai/api-reference/regulatory-graph-api/rebuild-published-regulatory-graph-projections-from-serving-facts.md)
- [Return graph node coverage for published regulatory facts](https://docs.esheria.ai/api-reference/regulatory-graph-api/return-graph-node-coverage-for-published-regulatory-facts.md)
- [Return pack applicability results with published relationship context](https://docs.esheria.ai/api-reference/regulatory-graph-api/return-pack-applicability-results-with-published-relationship-context.md)
- [Summarize entity profile context from published pack and relationship facts](https://docs.esheria.ai/api-reference/regulatory-graph-api/summarize-entity-profile-context-from-published-pack-and-relationship-facts.md)
- [Create or update a regulatory source watch](https://docs.esheria.ai/api-reference/regulatory-monitoring-api/create-or-update-a-regulatory-source-watch.md)
- [List configured regulatory source watches](https://docs.esheria.ai/api-reference/regulatory-monitoring-api/list-configured-regulatory-source-watches.md)
- [List recorded regulatory source-change events](https://docs.esheria.ai/api-reference/regulatory-monitoring-api/list-recorded-regulatory-source-change-events.md)
- [List source currentness from the latest monitoring snapshots](https://docs.esheria.ai/api-reference/regulatory-monitoring-api/list-source-currentness-from-the-latest-monitoring-snapshots.md)
- [List source or fact changes queued for regulatory pack recompile](https://docs.esheria.ai/api-reference/regulatory-monitoring-api/list-source-or-fact-changes-queued-for-regulatory-pack-recompile.md)
- [Run source snapshot and change detection for configured watches](https://docs.esheria.ai/api-reference/regulatory-monitoring-api/run-source-snapshot-and-change-detection-for-configured-watches.md)
- [Check which obligations potentially apply to an entity profile](https://docs.esheria.ai/api-reference/regulatory-pack-api/check-which-obligations-potentially-apply-to-an-entity-profile.md)
- [Diff canonical facts between two regulatory domain pack versions](https://docs.esheria.ai/api-reference/regulatory-pack-api/diff-canonical-facts-between-two-regulatory-domain-pack-versions.md)
- [Export the published regulatory pack](https://docs.esheria.ai/api-reference/regulatory-pack-api/export-the-published-regulatory-pack.md)
- [Inspect a regulatory domain pack summary](https://docs.esheria.ai/api-reference/regulatory-pack-api/inspect-a-regulatory-domain-pack-summary.md)
- [List current regulatory domain packs](https://docs.esheria.ai/api-reference/regulatory-pack-api/list-current-regulatory-domain-packs.md)
- [List historical versions for a regulatory domain pack](https://docs.esheria.ai/api-reference/regulatory-pack-api/list-historical-versions-for-a-regulatory-domain-pack.md)
- [List published obligations for a regulatory domain pack](https://docs.esheria.ai/api-reference/regulatory-pack-api/list-published-obligations-for-a-regulatory-domain-pack.md)
- [List stored or generated legal change events for a regulatory domain pack](https://docs.esheria.ai/api-reference/regulatory-pack-api/list-stored-or-generated-legal-change-events-for-a-regulatory-domain-pack.md)
- [Return canonical legal review and publication audit metadata](https://docs.esheria.ai/api-reference/regulatory-pack-api/return-canonical-legal-review-and-publication-audit-metadata.md)
- [Return evidence requirements grouped by evidence type](https://docs.esheria.ai/api-reference/regulatory-pack-api/return-evidence-requirements-grouped-by-evidence-type.md)
- [Return published relationship facts involving a regulatory domain pack](https://docs.esheria.ai/api-reference/regulatory-pack-api/return-published-relationship-facts-involving-a-regulatory-domain-pack.md)
- [Return regulatory filing and deadline calendar items](https://docs.esheria.ai/api-reference/regulatory-pack-api/return-regulatory-filing-and-deadline-calendar-items.md)
- [Return source-traced penalty and consequence facts](https://docs.esheria.ai/api-reference/regulatory-pack-api/return-source-traced-penalty-and-consequence-facts.md)
- [Verify a legal claim against a selected regulatory pack](https://docs.esheria.ai/api-reference/regulatory-pack-api/verify-a-legal-claim-against-a-selected-regulatory-pack.md)
- [Get the current workspace](https://docs.esheria.ai/api-reference/workspace/get-the-current-workspace.md)
- [Update the current workspace settings](https://docs.esheria.ai/api-reference/workspace/update-the-current-workspace-settings.md)
- [Changelog](https://docs.esheria.ai/changelog/index.md): Release notes for Esheria developer surfaces.
- [CLI](https://docs.esheria.ai/cli/index.md): Install and use the esheria command-line interface for API smoke checks and regulatory pack workflows.
- [API Keys](https://docs.esheria.ai/guides/api-keys.md): Store, rotate, and test Esheria API keys without leaking credentials.
- [Authentication](https://docs.esheria.ai/guides/authentication.md): Use API keys, idempotency keys, and trace IDs safely across Esheria API workflows.
- [Billing and Credits](https://docs.esheria.ai/guides/billing-and-credits.md): Production plans, workspace credits, server-owned Checkout SKUs, metering, and payment safety.
- [Change Monitoring](https://docs.esheria.ai/guides/change-monitoring.md): Use pack versions, diffs, and change events to answer what changed since the last sync.
- [Citations And Evidence](https://docs.esheria.ai/guides/citations-and-evidence.md): Keep source IDs, quote spans, evidence requirements, and trace IDs attached to every regulatory answer.
- [Claim Verification](https://docs.esheria.ai/guides/claim-verification.md): Verify generated or user-supplied regulatory claims against published facts and citation spans.
- [Self-Serve Dashboard](https://docs.esheria.ai/guides/dashboard-self-serve.md): Sign up, create API tokens, monitor usage, manage credits, and test Esheria API calls from dashboard.esheria.ai.
- [Filing, Evidence, And Penalties](https://docs.esheria.ai/guides/filing-evidence-and-penalties.md): Use first-class filing rules, evidence requirements, penalty facts, and review audit metadata.
- [Obligations](https://docs.esheria.ai/guides/obligations.md): List and filter published obligations for a regulatory pack.
- [Production Pack Catalog](https://docs.esheria.ai/guides/pack-catalog.md): Complete current API catalog across jurisdictions, legal domains, readiness states, and published fact counts.
- [Regulatory Packs](https://docs.esheria.ai/guides/packs.md): Discover available packs, inspect readiness labels, and choose the right pack for a workflow.
- [Rate Limits And Timeouts](https://docs.esheria.ai/guides/rate-limits-and-timeouts.md): Design clients that handle local rate limits, timeouts, retries, and idempotent replay safely.
- [Regulatory Intelligence](https://docs.esheria.ai/guides/regulatory-intelligence.md): Monitor sources, rebuild graph coverage, preview customer lifecycle applicability, and optionally track hosted customer change impacts.
- [Esheria](https://docs.esheria.ai/index.md): Contextualised, computable legal knowledge for product, compliance, and agent workflows.
- [Quickstart](https://docs.esheria.ai/quickstart.md): Make the first API request, install the CLI, configure MCP, and verify a citation-backed claim.
- [Examples](https://docs.esheria.ai/recipes/examples.md): Copy-paste API, Python, CLI, and MCP examples for the core regulatory workflows.
- [Errors](https://docs.esheria.ai/reference/errors.md): Interpret API error envelopes and recover from common authentication, idempotency, validation, and capability failures.
- [Solutions And Use Cases](https://docs.esheria.ai/solutions/use-cases.md): API, CLI, and MCP workflows for legal teams, compliance builders, and agentic products.

## OpenAPI Specs

- [openapi](https://docs.esheria.ai/openapi.json)