Ask

Structured, cited answer over the resolved graph (ask/v1)

Deterministic question-answering: a typed question and identifier in, a cited answer out. Available provenance fields identify the source and date; fields can be null and are not individually signed. No language model is in the retrieval path. For the sanctions question, an empty answer is returned only when the internal OIG coverage guard reports reconciled current; that state is not a same-day upstream-freshness claim. Stale or indeterminate coverage returns 503 and is not a clearance. A 400 returns the endpoint's self-documenting question catalog.

get/api/v1/ask

Request

  • Base URL: https://fonteum.com
  • URL: https://fonteum.com/api/v1/ask
  • Auth: HTTP bearer

Query parameters

question'ownership' | 'sanctions' | 'payments' required

ownership (1-hop entity-graph edges), sanctions (OIG LEIE exclusions by NPI), payments (CMS Open Payments by recipient NPI or teaching-hospital CCN).

schemestring required
Example:npi

Identifier scheme accepted by the question (e.g. npi, ccn). The 400 catalog lists accepted schemes per question.

valuestring required
Example:1003000118

Identifier value; normalized per scheme.

Response

Cited answer.

question'ownership' | 'sanctions' | 'payments'
answer_textstring
fact_countinteger
facts_truncatedboolean
citationsobject[]
coverage_status'current' | 'coverage_stale' | 'indeterminate'
determination'match' | 'no_match' | 'indeterminate'
methodology_versionstring

Example response

{
  "methodology_version": "v2026.05.0"
}

Changes

No recorded changes to this operation across all 1 revision of this API.