Skip to main content
The fact must be declared first. Candidates are the nodes carrying that fact_key that were known at as_of (and, with valid_at, in force then). The declared policy picks one. When it cannot, the answer says so and attaches every candidate.

Request

string
required
The fact_key. A key with no exact declaration in force uses the declaration of its key shape (*/language for s_1/language) when there is one.
timestamp or date
required
timestamp
timestamp
Apply the declaration that was in force at this instant instead of at as_of. Declarations are time-aware, so a fact declared today is undeclared_fact for a 2024 as_of unless you pass rules_as_of. When given, it is recorded in the certificate.
object
The case you are asking about, as {key: value}, for example {"filing_status": "single", "tax_year": "2025-06-30"}. A candidate whose applies_if does not hold for it is not a candidate, and a SUPERSEDES edge from such a block is ignored, so the block it would have replaced stays live for this case. Conditions are checked as in list memories. Under most_specific the conditional finalists then answer instead of needs_facts. Without facts the answer is unchanged.

Response

Always 200.
string
answered or no_answer.
any
The chosen fact_value, when answered.
string
When no_answer: undeclared_fact (no declaration of the key or its shape at that instant), no_data (no node carries this key), not_yet (values exist but none was known at as_of), no_value_at (none in force at valid_at), unresolved_conflict (the policy cannot choose; all candidates attached), needs_facts (most_specific only: the best candidates carry applies_if conditions and the request passed no facts to check them against; all candidates attached). With facts, a fact whose every covering block is conditional and none applies to the case is no_value_at; the certificate’s not_applicable says how many were set aside.
string
The policy applied. Under most_specific a candidate that a SUPERSEDES edge known by as_of and in force at valid_at points to is dropped first; see declare facts.
object[]
Every candidate considered, with its value and times.
object
Scoped to this fact. Carries rules_as_of when it was given, and not_applicable (the number of candidates set aside for the case, 0 included) when facts was.
Add "valid_at": "2024-06-01" to the first request to ask “what was in force in June, as known in October”: the answer is up.
A conditional rule, resolved for one case
Under most_specific this answers with the head-of-household block when one applies, and with the default block for {"filing_status": "single"}, because the conditional block is set aside together with the SUPERSEDES edge it carries.