Contrie Verify API
The Verify API from Contrie — 1 operation(s) for verify.
The Verify API from Contrie — 1 operation(s) for verify.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/contrie-com:contrie-com-verify-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Contrie Com Verify API
version: 1.0.0
contact:
email: hello@contrie.com
description: 'Operations tagged Verify across 2 of this provider''s published API definitions: contrie-com-openapi.json, contrie-com-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://www.contrie.com
security:
- bearerAuth: []
tags:
- name: Verify
paths:
/api/v1/verify:
post:
operationId: verify
summary: Check extracted data against the page it claims to come from
description: Check supplied data against source text. This endpoint charges no customer credits. The same data and source bytes produce the same result. Text presence does not establish field attribution or factual truth.
security:
- bearerAuth: []
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/VerifyRequest'
responses:
'200':
description: Grounding report
content:
application/json:
schema:
$ref: '#/components/schemas/VerifyResponse'
'400':
description: Invalid request
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'422':
description: 'URL mode only: the source could not be fetched or refused the request'
headers:
Retry-After:
schema:
type: integer
minimum: 1
maximum: 86400
description: 'Present only on SOURCE_REFUSED when the source answered 429, or on FETCH_FAILED when it answered 503, with a usable Retry-After: the source''s wait in whole seconds, an HTTP-date converted to seconds, kept between 1 and 86400. A SOURCE_REFUSED whose message says to retry later means retry later even without it.'
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'429':
description: 'RATE_LIMITED (the account''s per-minute limit by plan: Free 10, Builder 30, Pro 100 requests per minute; or about 20 failed authentication attempts a minute from one client, which answers with Retry-After 60), PAGE_LIMIT_REACHED (credits unavailable) or INFERENCE_BUDGET_EXCEEDED (a processing limit). Retry-After is present only when waiting helps.'
headers:
Retry-After:
schema:
type: integer
description: Seconds until the caller may retry
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'500':
description: Verification failed
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'503':
description: Service unavailable
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'403':
description: OAuth token lacks the required Contrie account scope. See WWW-Authenticate for the required scope.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
tags:
- Verify
servers:
- url: https://www.contrie.com
components:
schemas:
VerifyResponse:
type: object
required:
- success
- verdict
- coverage
- fields
- metadata
properties:
success:
type: boolean
grounding:
type:
- number
- 'null'
minimum: 0
maximum: 1
description: Fraction of checkable values found in the page. Null when nothing was checkable — never 0, which would read as 'every value was invented'.
verdict:
type: string
enum:
- all-grounded
- ungrounded-values
- nothing-checkable
coverage:
allOf:
- $ref: '#/components/schemas/GroundingCoverage'
description: 'Also carries ''ungrounded'': the checkable values not found in the page.'
fields:
type: array
items:
$ref: '#/components/schemas/FieldGrounding'
description: Per-value verdicts, ungrounded first, capped at 50.
metadata:
type: object
properties:
url:
type:
- string
- 'null'
description: Final URL after redirects for url; for html, the caller's baseUrl, never fetched (null without one).
source:
type: string
enum:
- fetched
- html
- text
latencyMs:
type: integer
description: Time in milliseconds to resolve the source, including any fetch, and check the values.
credits:
type: integer
enum:
- 0
description: This endpoint does not charge customer credits.
VerifyRequest:
type: object
required:
- data
description: Exactly one of url, html or text must be given.
properties:
data:
description: 'The extracted data to check: any JSON value.'
url:
type: string
format: uri
description: Page to fetch and check the data against.
html:
type: string
maxLength: 5000000
description: 'Source HTML, when the caller already has it. Without baseUrl, relative links stay relative: a relative href cannot ground an absolute URL value, which an extraction of the same page (which knows its URL) could. Keep the whole request body under the platform''s 4.5 MB limit.'
baseUrl:
type: string
format: uri
description: 'With html only: the page the HTML came from. Resolves relative links the way an extraction of that page would. Never fetched.'
text:
type: string
maxLength: 5000000
description: Source text, when the caller already has it. Keep the whole request body under the platform's 4.5 MB limit.
options:
type: object
properties:
timeout:
type: integer
minimum: 1000
maximum: 30000
default: 15000
ErrorResponse:
type: object
required:
- success
- error
properties:
success:
type: boolean
enum:
- false
error:
type: object
required:
- code
- message
properties:
code:
type: string
enum:
- INVALID_REQUEST
- INVALID_URL
- IDEMPOTENCY_CONFLICT
- IDEMPOTENCY_EXPIRED
- IDEMPOTENCY_OUTCOME_UNKNOWN
- REQUEST_IN_PROGRESS
- NOT_FOUND
- UNAUTHORIZED
- INSUFFICIENT_SCOPE
- PAYMENT_REQUIRED
- FETCH_FAILED
- SOURCE_REFUSED
- RENDER_REQUIRED
- RATE_LIMITED
- PAGE_LIMIT_REACHED
- SERVICE_UNAVAILABLE
- MODELS_UNAVAILABLE
- EXTRACTION_FAILED
- INFERENCE_BUDGET_EXCEEDED
- INFERENCE_UNAVAILABLE
- RESULT_NOT_ACCEPTED
message:
type: string
GroundingCoverage:
type: object
required:
- total
- checkable
- grounded
description: How much of the data a grounding ratio speaks for.
properties:
total:
type: integer
description: Values that assert something; nulls are not counted. Acceptance requires grounded to be at least half of this.
checkable:
type: integer
description: How many of those carried enough text to search for. Booleans and strings under three characters do not; numbers are checked at any length. They still count in total, as values that were not found.
grounded:
type: integer
description: How many of the checkable values were found in the page.
FieldGrounding:
type: object
required:
- path
- value
- grounded
properties:
path:
type: string
description: JSONPath-style location of the value inside data, e.g. $.stories[0].title. Keys that are not plain identifiers use bracket notation with JSON-escaped quotes, e.g. $["price (USD)"]; array elements are always numeric, e.g. $.items[0].
value:
type: string
description: The extracted value, rendered as a string.
grounded:
type: boolean
description: 'Whether this value''s text was located in the page text by the presence check: strings case-insensitive, with whitespace runs collapsed and the page''s bold, italic and inline-code markers read as formatting (a value''s own * or ` must be on the page); links as the same URL; numbers by value (31.0 matches 31); an ISO date also as the page writes it in words, inside an ISO timestamp, or as a numeric date in the day/month order the page''s own dates establish; GBP, EUR and INR as their symbol beside an amount (£53.74). It shows presence, not that the text belongs to this field or entity. False means unconfirmed by this check, not disproved: a value the page presents differently can be missed.'
excerpt:
type: string
description: Page text surrounding the match, roughly 45 characters either side, with case preserved and whitespace runs collapsed. Absent when grounded is false.
securitySchemes:
bearerAuth:
type: http
scheme: bearer
bearerFormat: Contrie API key or resource-bound OAuth access JWT
description: API key created at https://www.contrie.com/dashboard/keys (human sign-up in a browser; there is no programmatic key issuance), or an OAuth access token from the advertised Contrie sign-in flow. OAuth needs no additional API key. Configure credentials through the client or environment, never in a URL or agent chat.
x-refined-from:
- contrie-com-openapi.json
- contrie-com-openapi.yml