Code402 Multimodal API

openapi: 3.2.0
info:
  title: Code402 Dev Multimodal API
  version: 1.3.0
  contact:
    name: JUANA LIMITED (HCRB / Code402)
    url: https://hcrb.in
    email: support@code402.dev
  x-guidance: 'Pay-per-call deterministic checks with machine-readable x402 challenges. PAID routes declare a published floor in x-payment-info; the 402 challenge body is authoritative for recipient, amount, asset and network, and the configured gas-cost floor may raise the amount — read accepts[0] before authorizing. FREE routes carry security: []. Start with the four flagship checks (iban-check, lei-check, vat-mod97-check, swift-bic-check): 5 free calls/day per caller, then the published per-call floor. If 77 routes is more than your budget allows, GET /.well-known/x402.slim.json for a four-route first-call manifest instead. Receipt verification is free and needs no account: POST /v1/receipt/verify or /v1/receipt/verify/batch (up to 1000 per request), and verifying keys are public at /.well-known/jwks.json so verification never requires calling us. A valid receipt proves the declared signer signed those exact bytes — not settlement, delivery, ownership or the truth of a business claim. Non-custodial throughout: payer to seller, no deposit, no float.'
  x-provider-name: JUANA LIMITED (HCRB / Code402)
  description: 'Operations tagged Multimodal across 2 of this provider''s published API definitions: code402-dev-openapi-hcrb.json, code402-dev-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://hcrb.in
tags:
- name: Multimodal
paths:
  /multimodal/verify-artifact:
    post:
      operationId: vertical_multimodal_verify_artifact
      summary: Verify supplier invoice document SHA-256 hash and validate tax and bank…
      description: 'Verify supplier invoice document SHA-256 hash and validate tax and bank identifiers (IBAN, LEI, VAT, Norwegian orgnr) with a signed XDR-1 receipt (tier: ''micro'', 10,000 minor / $0.01 USDC). Paid via x402: sign accepts[0] EIP-3009 authorization and retry with PAYMENT-SIGNATURE. MCP tool: hcrb_multimodal_verify_artifact.'
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
            example:
              tier: micro
              single_document: true
              counterparty_name: EQUINOR ASA
              iban: NO9386011117947
              no_orgnr: '971036081'
      responses:
        '200':
          description: Result with a signed XDR-1 receipt
          content:
            application/json:
              schema:
                type: object
        '400':
          description: Invalid input
        '402':
          description: Payment required (x402). The 402 challenge in PAYMENT-REQUIRED is authoritative for the exact amount and payee.
          content:
            application/json:
              schema:
                type: object
                properties:
                  x402Version:
                    type: integer
                  accepts:
                    type: array
                  error:
                    type: string
      x-payment-info:
        price:
          mode: dynamic
          currency: USD
          min: '0.01'
          max: '0.05'
        protocols:
        - x402: {}
        note: Published floor and ceiling. The 402 challenge body is authoritative for the exact amount; read accepts[0].amount before authorizing.
      tags:
      - Multimodal
    servers:
    - url: https://hcrb.in
components:
  securitySchemes:
    OperatorQuotaBearer:
      type: http
      scheme: bearer
      description: Prepaid non-custodial quota key (ck_live_...) purchased at https://hcrb.in/checkout
    X402PaymentSignature:
      type: apiKey
      in: header
      name: PAYMENT-SIGNATURE
      description: Base64-encoded EIP-3009 transferWithAuthorization voucher on Base (eip155:8453)
x-refined-from:
- code402-dev-openapi-hcrb.json
- code402-dev-openapi.yml