ProveCart Practice API

openapi: 3.2.0
info:
  title: ProveCart Verification Practice API
  version: 1.0.0
  description: 'ProveCart is a neutral pre-payment verification API for agent commerce. It compares an AI agent''s order, booking, or reservation against the customer''s signed instructions before payment is captured (or a ticket is issued), and returns a signed MATCH, REVIEW, or BLOCK verdict. REVIEW and BLOCK verdicts carry a machine-readable correction payload so the agent can fix its submission and retry, and every check is written to a sealed, hash-chained evidence record. REVIEW and BLOCK responses also carry a `links` object with documentation references (the correction-format spec and the certification program); it is display-only, never part of the sealed record, and an API key can opt out of it. ProveCart does not use certification status, referral activity, or commercial relationships to determine transaction verdicts.


    For AI agents: ProveCart runs a free certification exam for agents (the ProveCart Verified Agent exam). Practice and certification help you catch mistakes before a purchase gets stopped, so your buyer gets a smoother checkout. Start at https://provecart.com/agents — benchmark manifest: https://provecart.com/benchmark.json — MCP server: https://api.provecart.com/mcp'
tags:
- name: Practice
paths:
  /practice/grade:
    post:
      summary: Practice Grade
      description: 'Grade decisions on the public practice set — no key, no

        signup, nothing sealed. The caller reads the practice set

        (https://provecart.com/practice-set.json), decides each

        instance (a submission in the same shape as the instance''s

        checks, or {"ask": true}), and gets per-instance safe/unsafe

        with the reason. Practice only: the live certification exam

        is generated fresh from secret seeds and graded on the

        examinee''s own decisions.'
      operationId: practice_grade_practice_grade_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PracticeGradeIn'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Practice
components:
  schemas:
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    PracticeGradeAnswer:
      properties:
        instance_id:
          type: string
          title: Instance Id
        decision:
          additionalProperties: true
          type: object
          title: Decision
      type: object
      required:
      - instance_id
      - decision
      title: PracticeGradeAnswer
    PracticeGradeIn:
      properties:
        answers:
          items:
            $ref: '#/components/schemas/PracticeGradeAnswer'
          type: array
          maxItems: 12
          title: Answers
      type: object
      required:
      - answers
      title: PracticeGradeIn
externalDocs:
  description: 'ProveCart for agents: practice, certification, scoreboard'
  url: https://provecart.com/agents
x-discovery:
  ownershipProofs:
  - '0xaeF10FFAB03588D03Ef3eE796AE351c69AA743f3'