Contrie Verification API

The Verification API from Contrie — 2 operation(s) for verification.

GitHub OpenAPI

Operations 3

POST /api/v1/verification/runs Check explicit field relationships in supplied HTML (optional pilot) #
GET /api/v1/verification/runs List account-private saved field checks (optional pilot) #
GET /api/v1/verification/runs/{id} Recover one saved field check (optional pilot) #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • 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.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/contrie-com:contrie-com-verification-api"
All apis
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.

Get an API 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 Specification

contrie-com-verification-api-openapi.yml Raw ↑
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