Public API Docs

Entry points intended for web/mobile clients.

Church hymn, lesson feed, and public audio-share routes are documented separately at Church Public API Docs.

JSON route index: /api/docs/index.json · Ethics JSON: /api/docs/ethics.json · Ethics Public API Docs

• GET /api/v1/openapi.json All hosts — OpenAPI 3.1 contract for DBaD, DecencyMeter, and public API v1 routes. DBaD/DecencyMeter reviewers should use the DecencyMeter-hosted contract as canonical. Church-specific clients may still fetch the same route from the Church host while that scope remains active.
• GET /api/v1/papers All hosts — Paper metadata list with ETag support. Optional filters: q, topic, year. PDF-only archives may include artifact_text_path for an explicit summary TXT file.
• GET /api/v1/papers/checksums All hosts — SHA256 checksums for published paper artifacts.
• GET /api/v1/papers/{slug}/citation All hosts — APA + BibTeX citation payload.
• GET /api/v1/papers/{slug}/citation.bib All hosts — BibTeX download.
• GET /api/v1/papers/{slug}/markdown All hosts — Markdown export via API. Archive PDFs without source markdown return artifact summaries, not full-text transcriptions.
• GET /papers/{slug}.md All hosts — Markdown export or artifact summary for paper pages. Use the PDF link for complete archive text when a paper only has an artifact summary.
• GET /api/v1/methodology/summary All hosts — Compact methodology payload.
• GET /api/v1/ethics/status/history All hosts — Uptime and snapshot history used by public status cards. Supports window_hours and step_minutes.
• GET /api/v1/ethics/alias-observability Ethics — Legacy-host redirect probe summary to canonical ethics host.
• GET /api/v1/search/typeahead All hosts — Typeahead search across papers, methodology, and FAQ. Query params: q, limit.
• GET/POST /api/v1/ethics/calculator All hosts — Weighted ethics calculator payload.
• POST /api/v1/dbad/historical-verification-attestation/verify Ethics — Verify a signed historical token-verification attestation. Audit evidence only. The artifact is not trust-positive authorization and is not accepted by /api/v1/dbad/trust-continuation/check.
• GET /api/v1/dbad/status-field-compliance-snapshot Ethics — Compact public snapshot of the current status-value invariant. Returns the served hardening round, invariant text, prefix-stripping semantics, and sample bound status fields without requiring a full trace parse.
• GET /api/v1/dbad/composite-proof-bundle Ethics — Signed timestamped public proof bundle for current DBaD response shapes. Evidence only. Includes cache-busted status snapshot, trace API, trust-continuation check, token-verify samples, response headers, generated timestamp, and a signature. Tokens are redacted and findings still require fresh live endpoint fetches.
• POST /api/v1/dbad/composite-proof-bundle/verify Ethics — Verifies a composite proof bundle signature without making it authorization. Accepts a copied composite proof bundle or full API envelope and verifies the dbad_cpb_v1 signature. Returns non-authority verifier evidence only; it never validates trust-positive use.
• POST /api/v1/ethics/scenarios All hosts — Queue a public scenario submission for moderation review.
• POST /api/v1/ethics/api-key-requests All hosts — Queue API key request intake with app and use-case metadata.
• POST /api/v1/ethics/subscribe All hosts — Create a pending subscription in double-opt-in state.
• GET/POST /api/v1/ethics/subscribe/confirm All hosts — Confirm a pending updates subscription.
• GET /api/v1/open-data/sample All hosts — Anonymized aggregate sample dataset. Supports format=csv.
• POST /api/v1/wall/{post_id}/report All hosts — Queue moderation report for a public wall post. Accepts reason, details, and contact email.
• GET /api/v1/decency/survey/breakdown All hosts — Aggregate survey breakdown by region or age_band.

Most JSON endpoints support ETag revalidation via If-None-Match.