---
title: "verify_fact"
method: POST
path: "/v1/tools/verify_fact"
tags: ["tools"]
---

# verify_fact

`POST /v1/tools/verify_fact`

## Request

- Base URL: `https://opentax.invaro.ai`
- URL: `https://opentax.invaro.ai/v1/tools/verify_fact`
- Auth: one of:
  - HTTP bearer
  - none

Fact-check a claimed dollar amount about tax law ('the 2026 MFJ standard deduction is $32,200', 'CTC is $2,000 per child') against the corpus. Returns verified / refuted (with the correct value and citation) / unknown. Never states a verdict it cannot ground.

## Headers

- `X-OpenTax-Return-Id` string

## Request body

- object
  - `query` string, required: what the amount is, e.g. 'standard deduction'
  - `claimedAmount` union, required: dollars, e.g. 50000 or "1234.56"
    - number
    - string
  - `filingStatus` 'single' | 'mfj' | 'mfs' | 'hoh' | 'qss'
  - `asOf` string

## Response `200`

ok:true with the computed value, line set or lookup hits; ok:false with error.code when the engine refuses (NEEDS_FACTS, NO_APPLICABLE_RULE, UNHANDLED_ENUM_CASE)

- object
  - `ok` boolean, required

## Other responses

- `400`: transport-level error
- `401`: transport-level error
- `429`: transport-level error

---

[API](https://skmtc.dev/invaro/apis/opentax-rest-api.md) · [All operations](https://skmtc.dev/invaro/apis/opentax-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/invaro/apis/opentax-rest-api/revisions/61fd3e3e6018?raw)