Skip to content
Documentation/Numbers

Verify numeric arithmetic

Check a numeric claim against figures selected from retained source evidence.

Markdown
POST/api/v2/verify/numerichttps://api.webcite.co

When to use it

Supply one or two operands using IDs from Publish text source units or Locate latest source units. figure_index is zero-based within the selected source unit. Read the unit before choosing it. Do not substitute an upload asset ID or invent a source version.

escalate, not_applicable, null arithmetic, or unknown comparability are unresolved states. Do not translate them into supported.

A returned operand figure can carry comparator: "gte" when the source states a lower bound, such as 60+. Treat that figure as a minimum, not an exact value.

Request

No fixed public credit price is specified for this V2 operation.

Examples run on your server. Set WEBCITE_API_KEY first. Python examples use the requests package.

curl
curl --fail-with-body -X POST 'https://api.webcite.co/api/v2/verify/numeric' \
  -H "x-api-key: $WEBCITE_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "claim": "Revenue rose from 12.5 to 20.0, up 60%",
  "operands": [
    {
      "source_version_id": "YOUR_SOURCE_VERSION_ID",
      "representation_id": "YOUR_REPRESENTATION_ID",
      "source_unit_id": "YOUR_SOURCE_UNIT_ID",
      "figure_index": 0
    },
    {
      "source_version_id": "YOUR_SOURCE_VERSION_ID",
      "representation_id": "YOUR_REPRESENTATION_ID",
      "source_unit_id": "YOUR_SOURCE_UNIT_ID",
      "figure_index": 1
    }
  ]
}'

Request body

claimstringrequired
minLength: 1maxLength: 10000
operandsobject[]required
minItems: 1maxItems: 2
Show operands fields
figure_indexintegerrequired
minimum: 0maximum: 10000
representation_idstringrequired
source_unit_idstringrequired
source_version_idstringrequired

Response

HTTP 201 returns outcome, arithmetic, comparability, reason, scope, limitation, and operands. scope is arithmetic_only. Figure selection and the full semantic claim are not certified.

201 response

application/json

arithmeticobject | nullrequired
Show arithmetic fields
computednumber | nullrequired
reasonstringrequired
tolerancenumberrequired
verdictstringrequired

Values: "holds""fails""not_computable"

comparabilityobject | nullrequired
Show comparability fields
facetsobject[]required
Show facets fields
decidedBystring

Values: "code""judge"

facetstring

Values: "unit""scale""entity""period""basis"

pnumber | null
passedboolean | null
reasonstringrequired
verdictstringrequired

Values: "comparable""not_comparable""unknown"

limitationstringrequired
operandsobject[]required
Show operands fields
bindingstringrequired

Values: "retained_source_slice"

figureobjectrequired
Show figure fields
accountingboolean
comparatorstring

Values: "gte"

indexinteger
magnitudenumber
rawstring
scalenumber
signinteger

Values: -11

unitstring | null
unitClassstring

Values: "percent""percentage_point""basis_point""currency""none"

valuenumber
sourceobjectrequired
Show source fields
representation_idstring
source_unit_idstring
source_version_idstring
outcomestringrequired

Values: "supported""contradicted""escalate""not_applicable"

reasonstringrequired
scopestringrequired

Values: "arithmetic_only"

Errors

400 includes invalid claim or operand fields, an unavailable figure index, or ambiguous source numbers. Authentication and source ownership checks also apply. Do not retry with fabricated operand values.

Error handling and retry guidance