Verify a claimed limit against the cited rows held

A limit someone stated (in an AI's answer, a report) set beside every row find_limits keeps for it. confirmed: a row prints the same number, in the claim's unit or one that converts exactly (in decimal, by the engine's registry), under the claim's statistic when one is given; quote its cite. contradicted: rows are held and none prints it; held_otherwise gives the number each prints, with its own conditions. not_held: a refused block (place.not_held, parameter.unknown, rows.none_held, statistic.none_held) naming every instrument searched and its edition, a statement about our sources and never about whether the claim is true. not_comparable: rows held, none comparable with one number, each with its why. Equal is equal as exact decimals: a rounded number is another number. A row worked for water of a stated chemistry confirms the same number and never contradicts another.

get/verify

Request

  • Base URL: https://passage-data.com/api/v1
  • URL: https://passage-data.com/api/v1/verify
  • Auth: one of:
    • none
    • HTTP bearer
    • API key in header x-api-key

Query parameters

parameterstring required

The substance or measure the claim names (copper, ammonia, pH) or its CAS number.

valuestring required

The number the claim states, one decimal number: 0.10, 0,10, 1e-4.

unitstring required

The claim's unit: mg/L, µg/L (or ug/L), ng/L, mg/kg, µg/m³, pH ...

placestring

ISO 3166 code: US, US-OH, CA, CA-QC, DE, FR, IT, EU. A place also searches every place above it.

medium'water_discharge' | 'surface_water' | 'groundwater' | 'drinking_water' | 'soil' | 'ambient_air' | 'air_emission' | 'sediment' | 'leachate'
statisticstring

A row code: monthly_avg, thirty_day_avg, daily_max, daily_avg, weekly_avg, annual_avg, hourly_avg, four_day_avg, instant, composite, qualified_grab, ... An unknown code is refused with the list.

sentencestring

Optional: the sentence the claim came from (better sent by POST). Read for the claim's number and unit, never kept.

Response

A verdict, or a refused block (not_held: place.not_held, parameter.unknown, rows.none_held, statistic.none_held; parameter.ambiguous, statistic.unrecognised, unit.refused, unit.unrecognised)

queryobject
searchedobject
verdict'confirmed' | 'contradicted' | 'not_held' | 'not_comparable'
saysstring
reads_asstring
not_comparable_byobject
other_statisticsobject
listedobject
refusedobject

Changes

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