Contrie Verification API
The Verification API from Contrie — 2 operation(s) for verification.
Operations 3
POST
/api/v1/verification/runs
Check explicit field relationships in supplied HTML (optional pilot)
#
The Verification API from Contrie — 2 operation(s) for verification.
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-verification-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 Verification API
version: 1.0.0
contact:
email: hello@contrie.com
description: 'Operations tagged Verification 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: Verification
paths:
/api/v1/verification/runs:
post:
operationId: checkSnapshotFields
summary: Check explicit field relationships in supplied HTML (optional pilot)
description: 'Operator-enabled supplied-snapshot pilot, disabled by default. Existing OAuth bearer or API-key authentication; cookies alone do not authorize this route. No source fetch or extraction credits. Shared workspace limits: 20 runs/account/rolling day and two active, with a service-wide ceiling. Encrypted snapshot payloads last seven days; content-free retry identities last 30. Responses are private, no-store. Use a UUID v4 retry key with identical input after interruption. Completed unsupported/conflicting results are successful workflow responses with data withheld, not transport errors.'
security:
- bearerAuth: []
parameters:
- name: Idempotency-Key
in: header
required: true
schema:
type: string
format: uuid
pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$
description: Stable UUID v4 per new submission; reuse with identical input for recovery.
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/SnapshotVerificationRequest'
responses:
'201':
description: New completed execution saved.
content:
application/json:
schema:
$ref: '#/components/schemas/VerificationRunResponse'
'200':
description: Original saved execution replayed unchanged.
content:
application/json:
schema:
$ref: '#/components/schemas/VerificationRunResponse'
'202':
description: Execution still running; recover by execution ID.
content:
application/json:
schema:
$ref: '#/components/schemas/VerificationRunResponse'
'400':
description: 'INVALID_REQUEST: malformed contract, cursor or retry identity.'
content:
application/json:
schema:
$ref: '#/components/schemas/VerificationErrorResponse'
'401':
description: 'UNAUTHORIZED: missing/expired/revoked credential or closed account. OAuth challenge is returned.'
content:
application/json:
schema:
$ref: '#/components/schemas/VerificationErrorResponse'
headers:
WWW-Authenticate:
schema:
type: string
description: Existing Contrie OAuth resource metadata challenge.
'403':
description: 'INSUFFICIENT_SCOPE: OAuth token lacks the account capability.'
content:
application/json:
schema:
$ref: '#/components/schemas/VerificationErrorResponse'
'409':
description: 'IDEMPOTENCY_CONFLICT: same retry key, different input.'
content:
application/json:
schema:
$ref: '#/components/schemas/VerificationErrorResponse'
'410':
description: 'IDEMPOTENCY_EXPIRED: matching retry identity remains but payload expired; no new work is started.'
content:
application/json:
schema:
$ref: '#/components/schemas/VerificationErrorResponse'
'413':
description: 'INVALID_REQUEST: body exceeds 250,000 UTF-8 bytes.'
content:
application/json:
schema:
$ref: '#/components/schemas/VerificationErrorResponse'
'415':
description: 'INVALID_REQUEST: application/json required.'
content:
application/json:
schema:
$ref: '#/components/schemas/VerificationErrorResponse'
'429':
description: 'RATE_LIMITED: shared account RPM or snapshot pilot capacity.'
content:
application/json:
schema:
$ref: '#/components/schemas/VerificationErrorResponse'
headers:
Retry-After:
schema:
type: integer
description: Present when the shared RPM limiter supplies a retry delay; a pilot-capacity refusal may not supply one.
'503':
description: 'SERVICE_UNAVAILABLE: operator pilot disabled, unavailable protection/storage, or unconfirmed completion. Recover any returned executionId before retrying.'
content:
application/json:
schema:
$ref: '#/components/schemas/VerificationErrorResponse'
tags:
- Verification
get:
operationId: listSnapshotVerifications
summary: List account-private saved field checks (optional pilot)
description: 'Operator-enabled supplied-snapshot pilot, disabled by default. Existing OAuth bearer or API-key authentication; cookies alone do not authorize this route. No source fetch or extraction credits. Shared workspace limits: 20 runs/account/rolling day and two active, with a service-wide ceiling. Encrypted snapshot payloads last seven days; content-free retry identities last 30. Responses are private, no-store. Lists up to 25 summaries, newest first. Pass nextCursor as before for the next page. No review write endpoint is exposed.'
security:
- bearerAuth: []
parameters:
- name: before
in: query
required: false
schema:
type: string
format: uuid
pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$
responses:
'200':
description: Owned run summaries and nextCursor.
content:
application/json:
schema:
$ref: '#/components/schemas/VerificationHistoryResponse'
'400':
description: 'INVALID_REQUEST: malformed contract, cursor or retry identity.'
content:
application/json:
schema:
$ref: '#/components/schemas/VerificationErrorResponse'
'401':
description: 'UNAUTHORIZED: missing/expired/revoked credential or closed account. OAuth challenge is returned.'
content:
application/json:
schema:
$ref: '#/components/schemas/VerificationErrorResponse'
headers:
WWW-Authenticate:
schema:
type: string
description: Existing Contrie OAuth resource metadata challenge.
'403':
description: 'INSUFFICIENT_SCOPE: OAuth token lacks the account capability.'
content:
application/json:
schema:
$ref: '#/components/schemas/VerificationErrorResponse'
'429':
description: 'RATE_LIMITED: shared account RPM or snapshot pilot capacity.'
content:
application/json:
schema:
$ref: '#/components/schemas/VerificationErrorResponse'
headers:
Retry-After:
schema:
type: integer
description: Present when the shared RPM limiter supplies a retry delay; a pilot-capacity refusal may not supply one.
'503':
description: 'SERVICE_UNAVAILABLE: operator pilot disabled, unavailable protection/storage, or unconfirmed completion. Recover any returned executionId before retrying.'
content:
application/json:
schema:
$ref: '#/components/schemas/VerificationErrorResponse'
tags:
- Verification
servers:
- url: https://www.contrie.com
/api/v1/verification/runs/{id}:
get:
operationId: getSnapshotVerification
summary: Recover one saved field check (optional pilot)
description: 'Operator-enabled supplied-snapshot pilot, disabled by default. Existing OAuth bearer or API-key authentication; cookies alone do not authorize this route. No source fetch or extraction credits. Shared workspace limits: 20 runs/account/rolling day and two active, with a service-wide ceiling. Encrypted snapshot payloads last seven days; content-free retry identities last 30. Responses are private, no-store. Returns the original signed result without rechecking, refetching or resigning. Zero remaining extraction credits does not prevent recovery.'
security:
- bearerAuth: []
parameters:
- name: id
in: path
required: true
schema:
type: string
format: uuid
pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$
responses:
'200':
description: Owned run with its original result and dashboard link.
content:
application/json:
schema:
$ref: '#/components/schemas/VerificationRunResponse'
'401':
description: 'UNAUTHORIZED: missing/expired/revoked credential or closed account. OAuth challenge is returned.'
content:
application/json:
schema:
$ref: '#/components/schemas/VerificationErrorResponse'
headers:
WWW-Authenticate:
schema:
type: string
description: Existing Contrie OAuth resource metadata challenge.
'403':
description: 'INSUFFICIENT_SCOPE: OAuth token lacks the account capability.'
content:
application/json:
schema:
$ref: '#/components/schemas/VerificationErrorResponse'
'404':
description: 'NOT_FOUND: execution not owned by this account or expired.'
content:
application/json:
schema:
$ref: '#/components/schemas/VerificationErrorResponse'
'429':
description: 'RATE_LIMITED: shared account RPM or snapshot pilot capacity.'
content:
application/json:
schema:
$ref: '#/components/schemas/VerificationErrorResponse'
headers:
Retry-After:
schema:
type: integer
description: Present when the shared RPM limiter supplies a retry delay; a pilot-capacity refusal may not supply one.
'503':
description: 'SERVICE_UNAVAILABLE: operator pilot disabled, unavailable protection/storage, or unconfirmed completion. Recover any returned executionId before retrying.'
content:
application/json:
schema:
$ref: '#/components/schemas/VerificationErrorResponse'
tags:
- Verification
servers:
- url: https://www.contrie.com
components:
schemas:
VerificationErrorResponse:
allOf:
- $ref: '#/components/schemas/ErrorResponse'
- type: object
properties:
executionId:
type: string
format: uuid
pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$
dashboardUrl:
type: string
format: uri
description: A recoverable 503 may include executionId and dashboardUrl. Recover before deliberately starting new work.
VerificationQualifiers:
type: object
properties:
currency:
type: string
minLength: 1
maxLength: 32
period:
type: string
minLength: 1
maxLength: 32
unit:
type: string
minLength: 1
maxLength: 32
variant:
type: string
minLength: 1
maxLength: 32
temporal:
type: string
enum:
- current
- previous
required: []
additionalProperties: false
VerificationRunResponse:
type: object
properties:
run:
$ref: '#/components/schemas/VerificationRun'
dashboardUrl:
type: string
format: uri
description: Open while signed into the same account. This link is outside the signed result.
required:
- run
- dashboardUrl
additionalProperties: false
VerificationRun:
type: object
properties:
executionId:
type: string
format: uuid
pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$
state:
type: string
enum:
- running
- completed
- failed
createdAt:
type: string
format: date-time
expiresAt:
type: string
format: date-time
result:
oneOf:
- $ref: '#/components/schemas/SnapshotVerificationResult'
- type: 'null'
review:
oneOf:
- type: object
properties:
kind:
type: string
enum:
- wrong_acceptance
- missed_support
- missed_conflict
- other
note:
type: string
maxLength: 1000
required:
- kind
- note
additionalProperties: false
- type: 'null'
required:
- executionId
- state
- createdAt
- expiresAt
- result
- review
additionalProperties: false
description: Owner-scoped saved execution. Review is an unvalidated human observation, never writable through this API.
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
SnapshotVerificationResult:
type: object
properties:
version:
const: 1
executionId:
type: string
format: uuid
pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$
success:
type: boolean
status:
type: string
enum:
- supported
- conflict
- insufficient_evidence
- unsupported
- uncertain
data:
oneOf:
- type: object
additionalProperties:
type:
- string
- number
- boolean
- 'null'
- type: 'null'
fields:
type: array
items:
type: object
properties:
name:
type: string
entity:
type: string
property:
type: string
context:
$ref: '#/components/schemas/VerificationQualifiers'
origin:
type: string
excludeDeclaredHidden:
type: boolean
status:
type: string
enum:
- supported
- conflict
- insufficient_evidence
- unsupported
- uncertain
reason:
type: string
value:
type:
- string
- number
- boolean
- 'null'
passages:
type: array
items:
type: object
properties:
id:
type: string
entity:
type: string
property:
type: string
value:
type:
- string
- number
- boolean
- 'null'
origin:
type: string
qualifiers:
$ref: '#/components/schemas/VerificationQualifiers'
visibility:
type: string
fragments:
type: array
items:
type: object
properties:
text:
type: string
start:
type: integer
minimum: 0
end:
type: integer
minimum: 0
truncated:
type: boolean
required:
- text
- start
- end
- truncated
additionalProperties: false
description: Exact source substring; start/end are UTF-16 character offsets in supplied HTML, not UTF-8 byte offsets.
required:
- id
- entity
- property
- value
- origin
- qualifiers
- visibility
- fragments
additionalProperties: false
additionalPassages:
type: integer
minimum: 0
required:
- name
- entity
- property
- context
- origin
- excludeDeclaredHidden
- status
- reason
- passages
- additionalPassages
additionalProperties: false
proposedData:
type: object
additionalProperties:
type:
- string
- number
- boolean
- 'null'
metadata:
type: object
properties:
url:
type: string
contentHash:
type: string
mode:
const: provided_snapshot
createdAt:
type: string
format: date-time
sourceAuthenticated:
const: false
visibility:
const: static-only
sourceCompleteness:
const: unmeasured
recoveredEvidence:
type: boolean
evidence:
type: object
description: Optional Ed25519 v2 seal over the complete public response except metadata.evidence itself. Verify with POST /api/v1/evidence/verify or /evidence-verifier.mjs and a separately pinned public key.
properties:
version:
type: integer
alg:
type: string
enum:
- Ed25519
keyId:
type: string
signedAt:
type: string
format: date-time
packetHash:
type: string
signature:
type: string
covers:
type: array
items:
type: string
required:
- url
- contentHash
- mode
- createdAt
- sourceAuthenticated
- visibility
- sourceCompleteness
- recoveredEvidence
additionalProperties: false
required:
- version
- executionId
- success
- status
- data
- fields
- metadata
additionalProperties: false
description: Original signed workspace result. All fields must be supported to release whole-result data; otherwise data is null. Signature establishes integrity, not source origin, freshness, completeness or truth. Send run.result unchanged to /api/v1/evidence/verify.
VerificationHistoryResponse:
type: object
properties:
runs:
type: array
maxItems: 25
items:
type: object
properties:
executionId:
type: string
format: uuid
pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$
state:
type: string
enum:
- running
- completed
- failed
createdAt:
type: string
format: date-time
expiresAt:
type: string
format: date-time
status:
oneOf:
- type: string
enum:
- supported
- conflict
- insufficient_evidence
- unsupported
- uncertain
- type: 'null'
url:
type:
- string
- 'null'
reviewed:
type: boolean
dashboardUrl:
type: string
format: uri
required:
- executionId
- state
- createdAt
- expiresAt
- status
- url
- reviewed
- dashboardUrl
additionalProperties: false
nextCursor:
oneOf:
- type: string
format: uuid
pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$
- type: 'null'
required:
- runs
- nextCursor
additionalProperties: false
SnapshotVerificationRequest:
type: object
properties:
source:
type: object
properties:
url:
type: string
format: uri
maxLength: 2048
description: Descriptive HTTP(S) URL without credentials; never fetched or authenticated.
html:
type: string
minLength: 1
maxLength: 200000
description: Original supplied HTML, at most 200,000 UTF-8 bytes and valid Unicode. Markdown is not equivalent evidence.
required:
- url
- html
additionalProperties: false
contract:
type: object
properties:
version:
const: 1
fields:
type: object
minProperties: 1
maxProperties: 20
propertyNames:
pattern: ^[A-Za-z][A-Za-z0-9_]{0,63}$
not:
enum:
- constructor
- prototype
- __proto__
additionalProperties:
type: object
properties:
entity:
type: string
minLength: 1
maxLength: 256
property:
type: string
minLength: 1
maxLength: 128
type:
type: string
enum:
- string
- number
- boolean
normalization:
type: string
enum:
- identity
- number
- boolean
- period
- iso-date
origin:
type: string
enum:
- any
- body
- jsonld
- metadata
- microdata
- form
excludeDeclaredHidden:
type: boolean
nullable:
type: boolean
qualifiers:
$ref: '#/components/schemas/VerificationQualifiers'
required:
- entity
- property
- type
additionalProperties: false
required:
- version
- fields
additionalProperties: false
proposedData:
type: object
maxProperties: 20
propertyNames:
pattern: ^[A-Za-z][A-Za-z0-9_]{0,63}$
not:
enum:
- constructor
- prototype
- __proto__
additionalProperties:
anyOf:
- type: string
maxLength: 4096
- type: number
- type: boolean
- type: 'null'
description: Optional scalar values being checked. Must contain exactly every contract field; nested values and evidence IDs are rejected. Null can be accepted only for an explicitly nullable field with matching source support.
required:
- source
- contract
additionalProperties: false
description: Strict supplied-snapshot contract. Total request at most 250,000 UTF-8 bytes. No account ID, parser controls, evidence candidates or model options are accepted.
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