infinihash-com Demo API

openapi: 3.2.0
info:
  title: Infinihash KYC Demo API
  version: 1.0.0
  description: 'Identity verification, KYB, sanctions screening, UBO orchestration and periodic review.


    Auth: send your key as `X-API-Key: ` (or `Authorization: Bearer `).


    Most endpoints are mounted twice — at the root (`/kyc/...`) and under `/api` (`/api/kyc/...`). Prefer the `/api` form; it is what the hosted portals and SDKs use.


    Python SDK: `pip install "git+https://github.com/Infinihash/kyc-python@v0.1.0"` (https://github.com/Infinihash/kyc-python; runnable examples in examples/).'
  contact:
    name: Infinihash
    url: https://kyc.infinihash.com
servers:
- url: https://kyc-api.infinihash.com
  description: Production
tags:
- name: Demo
paths:
  /demo/extract:
    post:
      x-route-source:
        file: routes/demo.js
        method: post
        path: /extract
      summary: Run the public live demo
      description: 'Unauthenticated marketing demo. Takes NO input: it runs the production document extraction and sanctions screening against one bundled synthetic specimen passport and returns the live result. Nothing is stored. Results are cached in-process for 5 minutes; limited to 8 requests per IP per day.'
      tags:
      - Demo
      operationId: runDemoExtract
      security: []
      responses:
        '200':
          description: Extraction and screening result
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DemoExtractResult'
        '429':
          description: Daily per-IP demo limit reached
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DemoError'
        '502':
          description: demo_pipeline_error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DemoError'
        '503':
          description: demo_unconfigured (specimen document missing)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DemoError'
    get:
      x-route-source:
        file: routes/demo.js
        method: get
        path: /extract
      summary: Demo endpoint (GET not allowed)
      description: 'Always answers 405 with an Allow: POST header; use POST /demo/extract. Unauthenticated.'
      tags:
      - Demo
      operationId: demoExtractGet
      security: []
      responses:
        '405':
          description: method_not_allowed
          headers:
            Allow:
              schema:
                type: string
              description: POST
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DemoError'
components:
  schemas:
    DemoError:
      type: object
      required:
      - error
      properties:
        error:
          type: string
        detail:
          type: string
    DemoExtractResult:
      type: object
      required:
      - demo
      - sample_id
      - extracted
      - provider
      - confidence
      - sanctions
      - latency_ms
      - disclaimer
      - cached
      properties:
        demo:
          type: boolean
          enum:
          - true
        sample_id:
          type: string
          description: Bundled specimen document id.
        extracted:
          type: object
          properties:
            full_name:
              type:
              - string
              - 'null'
            date_of_birth:
              type:
              - string
              - 'null'
            document_number:
              type:
              - string
              - 'null'
            nationality:
              type:
              - string
              - 'null'
            expiry_date:
              type:
              - string
              - 'null'
            issuing_country:
              type:
              - string
              - 'null'
        provider:
          type: string
          description: Extraction provider that produced the result (e.g. myai, anthropic, gemini, both).
        confidence:
          type: string
          enum:
          - low
          - high
        sanctions:
          type: object
          properties:
            status:
              type: string
              description: Screening status, e.g. CLEAR, HIT, PARTIAL or ERROR.
            total_hits:
              type: integer
            lists_searched:
              type: integer
              description: Number of sanctions entries searched.
        latency_ms:
          type: integer
        disclaimer:
          type: string
        cached:
          type: boolean
          description: true when served from the 5-minute in-process cache.
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
    BearerAuth:
      type: http
      scheme: bearer