Check one claim against the official figure
Check stated figures against the official source: one claim or a batch of up to 20. Use it to fact-check a draft or an article. One call is metered per 5 claims; claims that come back unverifiable are not charged. You extract each claim into fields; the server does not read sentences. Take the number exactly as written and its scale word separately. Pass period only when the claim names one. Pick the indicator id with search_indicators when unsure (for Spanish municipalities use registered_unemployment_rate). Examples: "Spain's unemployment rate fell to 10.5% in the second quarter of 2026" -> {"claims": [{"indicator": "unemployment_rate", "place": "Spain", "period": "2026-Q2", "value": 10.5, "unit_hint": "percent"}]} "Texas has more than 31 million people" -> {"claims": [{"indicator": "population", "place": "Texas", "value": 31, "unit_hint": "millions", "qualifier": "at_least"}]} "US inflation was 3.2% in August 2026" -> {"claims": [{"indicator": "cpi_annual_change", "place": "United States", "period": "2026-08", "value": 3.2, "unit_hint": "percent"}]} "Spain has the third highest unemployment rate in the EU" -> {"claims": [{"indicator": "unemployment_rate", "place": "Spain", "value": 3, "kind": "rank", "rank_within": "EU"}]} Precision: a claim is read with the precision it states. "3.4%" covers 3.35 to 3.45 and "31 million" 30.5 to 31.5 million, both ends included; when the publisher states fewer decimals than the claim, the publisher's precision is used. Trailing zeros of a whole number are read as rounding to its last non-zero digit, keeping two significant digits: 1200 covers 1,150 to 1,250 and 2500000 covers 2,450,000 to 2,550,000, while 30 and 10 stay stated to the unit; qualifier exact turns this off. "about" doubles the band. at_least and at_most are inclusive bounds: "over 10%" holds for 10.0%. Verdicts: accurate (within that rounding); approximately_accurate (within 2% of the official value or twice the rounding band, whichever is wider, with the exact gap); inaccurate (with the official value and the gap); outdated (matches an earlier release that was revised, or an earlier period while a newer figure exists; outdated says which, and with as_of whether it was accurate when made); unverifiable (unknown indicator or place, ambiguous place, no data, or units that cannot be reconciled; error says why). Ranks are exact positions; a place tied with others holds every position the tie spans. Returns {results: [{index, claim, verdict, explanation, confidence: high | medium | low, notes?, official: {indicator, place, period, value, status?, source, transform?, inputs?, computed?, rank?}, comparison: {claimed, official, difference, relative_difference_percent, rounding, approximate_band, claimed_range}, reading?, readings?, outdated?, vintage?, newer_period?, error?}], summary, metered_calls}. comparison.claimed is the claim in the official unit. When a claim can be read several ways (a year on a monthly series: its last month or its average; a city and its province of the same name; a percent change of a rate: points or relative), every plausible reading is tested, the best one is returned in reading and the others in readings, and confidence is lowered. Say which reading the verdict rests on. In your answer, quote the official figure with its period and cite official.source.citation or url. Mention status provisional, estimated or low_reliability. Do not call a claim false when the verdict is unverifiable or approximately_accurate. Pass citation_style for formatted references.
Request
- Base URL: https://invokely.ai
- URL: https://invokely.ai/api/v1/check
- Auth: one of:
- HTTP bearer
- API key in header x-api-key
- none
Query parameters
Indicator id, for example "population", "unemployment_rate", "cpi_annual_change", "gdp_usd". Call search_indicators first when unsure.
Place name or id as in get_value: "Texas", "Spain", "United States", "Mataró", "es-prov-08", "fips:48453".
The number as written, without the scale word or the % sign: 31 for "31 million", 3.2 for "3.2%". Digits with a dot for decimals and no separators: convert "31,290,831" to 31290831, a decimal comma ("3,4%" in Spanish) to 3.4 and a thousands dot ("1.200") to 1200; exponents, words and symbols are refused. A string keeps trailing zeros ("3.40"), which state precision. Negative for a fall in a change claim. For rank, the position (3 for "third highest").
Only when the claim names one: "2026" (year), "2026-Q2" (quarter), "2026-S1" (half), "2026-08" (month). Leave it out, or pass "latest", for claims in the present tense ("is", "has").
The scale word or unit written: percent (%), percentage_points ("points"), thousands, millions, billions, trillions, or units (a plain number). Omit when nothing is written.
ISO 4217 code when the claim is money: "USD" for $, "EUR" for €. Invokely does not convert currencies; a claim in another currency than the indicator is unverifiable, with indicators in that currency suggested.
Omit for a plain statement. exact only when the claim says "exactly" (trailing zeros then count as digits); about ("about", "around", "nearly", "roughly"); at_least ("more than", "over", "above", "at least"); at_most ("less than", "under", "below", and "in the top 3" for ranks). Bounds are inclusive.
level (default): the figure itself. yoy: % change from a year earlier ("prices rose 3% over the year"). pct_change: % change from the previous period. yoy_diff, diff: the same changes in the indicator unit, points for rates ("unemployment fell 0.4 points"). per_capita, per_1000, per_100k: a total divided by population. rank: position among places ("third highest").
rank only: the area of the ranking, for example "EU" for "among EU countries", "United States" for states, "Texas" for its counties. Required below country level; omitted for countries means every country.
rank only: highest (default) or lowest first.
Optional ISO 3166-1 alpha-2 code to disambiguate the place.
When the claim was made or published, as a UTC date ("2026-09-15") or date and time with a zone. A claim that was right with the figures published then but was revised or superseded since comes back outdated with accurate_when_made true, and vintage shows then versus now. Level claims only.
Optional original sentence. Echoed back for your records and never interpreted.
Replaces the approximate band: share of the official value.
Replaces the approximate band: width in the unit of value and unit_hint.
Adds source.citations with the citation in this style (APA 7, MLA 9, Chicago author-date, Harvard, BibTeX or RIS), or in all six with all. The publisher is the author. Omit to keep the response short.
Language of names and definitions. Default en.
Response
Success. The body is {"data": ...}; the remaining allowance is in the x-invokely-remaining header.
Changes
No recorded changes to this operation across all 1 revision of this API.