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.

Claim verification is a guardrail workflow. Use it when an application, assistant, or review process has drafted a legal/regulatory claim and needs to check whether the published pack supports it. It is not the first step for most business workflows. Start with packs, obligations, applicability, evidence, and calendars; use claim verification to keep generated text grounded.

​
Request

curl --compressed -sS -X POST \
  "$ESHERIA_API_BASE_URL/api/v1/legal-status/verify-claim" \
  -H "content-type: application/json" \
  -H "x-api-key: $ESHERIA_API_KEY" \
  -H "idempotency-key: claim-verify-$(date +%s)" \
  -d '{
    "claim": "The Public Service Commission shall invite applications for the position of Data Commissioner within seven days of being notified of a vacancy.",
    "jurisdiction": "KE",
    "domain": "data_protection",
    "pack_id": "KE-DATA-PROTECTION",
    "limit": 3
  }' | jq

​
Response

Successful responses include status, publication mode, authority IDs, provision IDs, obligation IDs, citation IDs, quote spans, and any correction labels. 
{
  "status": "ok",
  "data": {
    "domain_pack_id": "KE-DATA-PROTECTION",
    "publication_mode": "published",
    "status": "likely_supported",
    "citation_ids": ["..."],
    "quote_spans": [
      {
        "citation_id": "...",
        "line_start": 1,
        "line_end": 1,
        "verification_status": "compiler_exact_span_candidate"
      }
    ],
    "issue_labels": ["generic_claim_profile_retrieval"]
  },
  "errors": [],
  "trace_id": "..."
}

​
Correction Example

If a generated answer changes a deadline or statutory detail, the verifier can return supported_with_corrections with issue labels such as deadline_mismatch. 
esheria claims verify \
  --pack KE-DATA-PROTECTION \
  --jurisdiction KE \
  --domain data_protection \
  "The Public Service Commission shall invite applications for the position of Data Commissioner within thirty days of being notified of a vacancy." \
  --format json

​
When Verification Is Unsupported

Some packs may not have a promoted claim_evaluation_profile. In that case, claim verification returns unsupported_capability. The pack can still support obligation, applicability, evidence, filing-calendar, export, and graph workflows.

​
Failure Modes

ResultMeaningProduct behavior
likely_supportedPublished facts support the claimShow the answer with citations and trace ID
supported_with_correctionsNearby source-backed fact supports a corrected versionShow correction context, not the original claim as final
unsupported_scopeClaim is outside supported scopeAsk for a narrower claim or route to review
not_foundNo supporting published fact foundDo not present the claim as source-backed
unsupported_capabilityPack lacks a claim verifierUse generic pack workflows instead