APIR API

openapi: 3.1.0
info:
  title: APIR API
  version: '2026-11-01'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-11-01: 22 operation(s) read from 12 public documentation page(s) (each
    operation names its page in x-source). This is not the provider''s published contract; APIR has published no machine-readable contract that
    the pipeline could find. Engine: oss.'
  x-evidence-tiers:
    code-example: 5
    documentation: 17
    pages-with-code: 8
    pages-read: 12
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-11-01'
  x-generator: generate-contract-from-docs.py
  x-engine: oss
  x-sources:
  - https://apir.ai/developers
  - https://apir.ai/docs
  - https://apir.ai/seal/check
  - https://apir.ai/how-to-prove-what-your-ai-agent-did
  - https://apir.ai/what-is-an-ai-agent-evidence-record
  - https://apir.ai/seal/9218f8fd-d732-4666-8c76-94d1571a1b74
  - https://api.apir.ai/seal/9218f8fd-d732-4666-8c76-94d1571a1b74
  - https://api.apir.ai/seal/check
  - https://api.apir.ai/developers
  - https://api.apir.ai/docs
  - https://api.apir.ai/what-is-an-ai-agent-evidence-record
  - https://api.apir.ai/how-to-prove-what-your-ai-agent-did
servers:
- url: https://podncdlwtknujadrtsxz.supabase.co/functions/v1/Audit
paths:
  /api/seal/api:
    get:
      operationId: get_api_seal_api
      tags:
      - Api
      summary: Check an API before you call it
      description: Enter the service’s domain to see whether someone who could make that domain answer has sealed a declaration about it.
      x-source: https://apir.ai/seal/check
      parameters:
      - name: domain
        in: query
        required: true
        schema:
          type: string
        description: Domain to check
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/seal/check:
    get:
      operationId: get_api_seal_check
      tags:
      - Api
      summary: GET /api/seal/check
      x-source: https://apir.ai/seal/check
      parameters:
      - name: sha256
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: curl "https://apir.ai/api/seal/check?sha256=<64 hex>" The evidence record for AI agents Show your AI's work. Ed25519 signed RFC
          3161 dated Checkable offline AI agents Check an agent, free The public registry, free Verify a passport, free Paper your first agent,
          free The Evidence Pack APIR’s own agents at work Watch one earn its passport How an agent is graded Wage or Crew Verification Seal a
          file,
  /api/v1/events:
    post:
      operationId: post_api_v1_events
      tags:
      - Api
      summary: Record agent events via POST /api/v1/events
      description: Inserts one or more conduct events for an agent into the immutable log.
      x-source: https://apir.ai/developers
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV1EventsRequest'
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiV1EventsResponse'
      x-evidence:
        kind: documentation
  /api/v1/profile:
    get:
      operationId: get_api_v1_profile
      tags:
      - Api
      summary: Lookup a business profile via GET /api/v1/profile
      description: Returns a dossier for a business based on name, ABN, ACN or website.
      x-source: https://apir.ai/developers
      parameters:
      - name: q
        in: query
        required: true
        schema:
          type: string
        description: Business name, ABN, ACN or website
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1ProfileResponse'
      x-evidence:
        kind: documentation
  /api/v1/resolve:
    get:
      operationId: get_api_v1_resolve
      tags:
      - Api
      summary: One endpoint, one question GET /api/v1/resolve?q=… takes an agent name, a credential ID, or an agent UUID.
      description: Resolves an agent identity, authority and record based on a query parameter.
      x-source: https://apir.ai/developers
      parameters:
      - name: q
        in: query
        required: true
        schema:
          type: string
        description: Agent name, credential ID (TP-…), or agent UUID
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1ResolveResponse'
      x-evidence:
        kind: documentation
    post:
      operationId: post_api_v1_resolve
      tags:
      - Api
      summary: POST /api/v1/resolve
      x-source: https://apir.ai/developers
      parameters:
      - name: q
        in: query
        required: false
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV1ResolveRequest'
      responses:
        '201':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiV1ResolveResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl JavaScript Python MCP curl · request copy curl \"https://apir.ai/api/v1/resolve?q=TP-EXAMPLE0-00000000\"  -H \"Authorization:\
          \ Bearer apir_sk_your_key\" response · example shape, illustrative values copy {\n \"verdict\": \"VERIFIED\",\n \"query\": \"TP-EXAMPLE0-00000000\"\
          ,\n \"checked_at\": \"2026-08-13T04:20:11.000Z\",\n \"agent\": { \"name\": \"Example Agent\", \"status\": \"active\" },\n \"identity\"\
          : {\n \"verified\": true,\n"
  /api/v1/seal:
    post:
      operationId: post_api_v1_seal
      tags:
      - Api
      summary: POST /api/v1/seal
      x-source: https://apir.ai/developers
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV1SealRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -X POST https://apir.ai/api/v1/seal  -H \"Authorization: Bearer apir_sk_...\"  -H \"Content-Type: application/json\"  -d\
          \ '{\"declarant_name\":\"Ana Ruiz\",\"kind\":\"artwork\",\n \"method\":\"human_made\",\"title\":\"Harbour, oil on linen\",\n \"statement\"\
          :\"Painted by me over March and April 2026, no generative AI.\",\n \"files\":[{\"name\":\"harbour.tif\",\"size\":48213000,\"sha256\"\
          :\"<64 hex>\"}],\n \"confirmed\":true}' Hash the"
  /functions/v1/run-ghost-audit:
    get:
      operationId: get_functions_v1_run_ghost_audit
      tags:
      - Functions
      summary: GET /functions/v1/run-ghost-audit
      x-source: https://apir.ai/docs
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetFunctionsV1RunGhostAuditResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl const response = await fetch(\n 'https://podncdlwtknujadrtsxz.supabase.co/functions/v1/run-ghost-audit',\n {\n method:\
          \ 'POST',\n headers: {\n 'Authorization': 'Bearer <your session JWT>',\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify({\
          \ agentId: '<agent uuid>' })\n }\n);\nconst run = await response.json(); Access model Access model Verifying an agent's evidence is\
          \ free forever, no auth"
    post:
      operationId: post_functions_v1_run_ghost_audit
      tags:
      - Functions
      summary: POST /functions/v1/run-ghost-audit
      x-source: https://apir.ai/docs
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostFunctionsV1RunGhostAuditRequest'
      responses:
        '201':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostFunctionsV1RunGhostAuditResponse'
      x-evidence:
        kind: code-example
        language: javascript
        snippet: "fetch(\n 'https://podncdlwtknujadrtsxz.supabase.co/functions/v1/run-ghost-audit',\n {\n method: 'POST',\n headers: {\n 'Authorization':\
          \ 'Bearer <your session JWT>',\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify({ agentId: '<agent uuid>' })"
  /run-ghost-audit:
    post:
      operationId: post_run_ghost_audit
      tags:
      - Run Ghost Audit
      summary: POST / run-ghost-audit
      x-source: https://apir.ai/docs
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/external-verify:
    get:
      operationId: get_v1_external_verify
      tags:
      - External Verify
      summary: 'Public: free, no key'
      x-source: https://apir.ai/docs
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    post:
      operationId: post_v1_external_verify
      tags:
      - External Verify
      summary: 'Public: free, no key'
      x-source: https://apir.ai/docs
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/trust-lookup:
    get:
      operationId: get_v1_trust_lookup
      tags:
      - Trust Lookup
      summary: 'Public: free, no key'
      x-source: https://apir.ai/docs
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    post:
      operationId: post_v1_trust_lookup
      tags:
      - Trust Lookup
      summary: 'Public: free, no key'
      x-source: https://apir.ai/docs
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/verify-attestation:
    get:
      operationId: get_v1_verify_attestation
      tags:
      - Verify Attestation
      summary: 'Public: free, no key'
      x-source: https://apir.ai/docs
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    post:
      operationId: post_v1_verify_attestation
      tags:
      - Verify Attestation
      summary: 'Public: free, no key'
      x-source: https://apir.ai/docs
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/verify-black-box:
    get:
      operationId: get_v1_verify_black_box
      tags:
      - Verify Black Box
      summary: 'Public: free, no key'
      x-source: https://apir.ai/docs
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    post:
      operationId: post_v1_verify_black_box
      tags:
      - Verify Black Box
      summary: 'Public: free, no key'
      x-source: https://apir.ai/docs
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/verify-genome-integrity:
    get:
      operationId: get_v1_verify_genome_integrity
      tags:
      - Verify Genome Integrity
      summary: 'Public: free, no key'
      x-source: https://apir.ai/docs
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    post:
      operationId: post_v1_verify_genome_integrity
      tags:
      - Verify Genome Integrity
      summary: 'Public: free, no key'
      x-source: https://apir.ai/docs
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/verify-passport:
    get:
      operationId: get_v1_verify_passport
      tags:
      - Verify Passport
      summary: 'Public: free, no key'
      x-source: https://apir.ai/docs
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    post:
      operationId: post_v1_verify_passport
      tags:
      - Verify Passport
      summary: 'Public: free, no key'
      x-source: https://apir.ai/docs
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
components:
  schemas:
    PostApiV1EventsRequest:
      type: object
      properties:
        agent_id:
          type: string
          description: The identifier of the agent
        events:
          type: array
          description: Array of event objects
      required:
      - agent_id
      - events
    PostApiV1EventsResponse:
      type: object
      properties:
        sequence_number:
          type: integer
          description: Sequence number assigned to each stored event
        chain_hash:
          type: string
          description: Hash linking the event into the hash‑chained log
    GetApiV1ProfileResponse:
      type: object
      properties:
        entity:
          type: object
          description: Entity information from the register
        facts:
          type: object
          description: Site's own facts about the business
        domain_dates:
          type: object
          description: Domain registration dates
        sources:
          type: array
          description: List of sources consulted
        read_dates:
          type: object
          description: Date each source was read
    GetApiV1ResolveResponse:
      type: object
      properties:
        verdict:
          type: string
          description: Overall verification verdict
        query:
          type: string
          description: The query that was resolved
        checked_at:
          type: string
          description: Timestamp of the check
        agent:
          type: object
          description: Agent basic info
        identity:
          type: object
          description: Identity verification details
        authority:
          type: object
          description: Authority delegation chain
        record:
          type: object
          description: Sealed events count and last activity
        credential:
          type: object
          description: Credential trust information
        verify_yourself:
          type: object
          description: Public key location and note
        billing:
          type: object
          description: Metering information
    PostApiV1ResolveRequest:
      type: object
      properties:
        agent_id:
          type: string
        events:
          type: array
          items:
            type: object
            properties:
              type:
                type: string
              summary:
                type: string
              input_hash:
                type: string
              output_hash:
                type: string
              data:
                type: object
                properties:
                  tool:
                    type: string
    PostApiV1ResolveResponse:
      type: object
      properties:
        metered:
          type: boolean
        month_checks:
          type: integer
        free_tier:
          type: integer
    PostApiV1SealRequest:
      type: object
      properties:
        declarant_name:
          type: string
        kind:
          type: string
        method:
          type: string
        title:
          type: string
        statement:
          type: string
        files:
          type: array
          items:
            type: object
            properties:
              name:
                type: string
              size:
                type: integer
              sha256:
                type: string
        confirmed:
          type: boolean
    GetFunctionsV1RunGhostAuditResponse:
      type: object
      properties:
        error:
          type: string
        pack:
          type: string
        reason:
          type: string
        message:
          type: string
    PostFunctionsV1RunGhostAuditRequest:
      type: object
      properties:
        agentId:
          type: string
    PostFunctionsV1RunGhostAuditResponse:
      type: object
      properties:
        error:
          type: string
        pack:
          type: string
        reason:
          type: string
        message:
          type: string
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
security:
- bearer: []
tags:
- name: Api
- name: External Verify
- name: Functions
- name: Run Ghost Audit
- name: Trust Lookup
- name: Verify Attestation
- name: Verify Black Box
- name: Verify Genome Integrity
- name: Verify Passport