Sefer APIs

Trust model

References, strict citations, inferred leads, and evidence.

Two reference dialects

The resolver accepts both English-canonical references such as Genesis 1:1 and Berakhot 42a:10, and Hebrew-daf forms such as Berakhot מב., י. A deterministic normalizer bridges them and returns the canonical hit when one exists.

Citations are strict

GET /v1/citations returns only:

  1. curated graph links, labeled trust_basis: "curated_link"; or
  2. explicit extracted citations with non-empty evidence_hebrew, labeled trust_basis: "explicit_evidence".

human_verified is true only for curated links. Model confidence is intentionally absent from this endpoint; a model score is not verification.

Leads stay leads

GET /v1/leads contains non-curated relationships that do not meet the strict citation contract. They use leads_to and led_to_by, expose model_score, and retain provenance and any available evidence excerpt. Use them for discovery, not as citations-of-record.

Response identity

API responses include a request_id. Graph responses also report latency_ms; metered graph responses carry X-Engine-Invocation-Id, X-Engine-Charge-Usd, and X-Engine-Measurement headers.

On this page