FOXIFY API

openapi: 3.1.0
info:
  title: FOXIFY API
  version: '2026-11-08'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-11-08: 10 operation(s) read from 6 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; FOXIFY has published no machine-readable contract that the pipeline
    could find. Engine: local.'
  x-evidence-tiers:
    code-example: 2
    documentation: 8
    pages-with-code: 5
    pages-read: 6
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-11-08'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://foxify.pro/developers
  - https://foxify.pro/api/basket/schema
  - https://foxify.pro/machine-start
  - https://foxify.pro/security-practice
  - https://foxify.pro/github-agent-authority-action
  - https://foxify.pro/machine-start?src=action-page
servers:
- url: https://x402.foxify.pro
paths:
  /action-preflight:
    post:
      operationId: post_action_preflight
      tags:
      - Action Preflight
      summary: Exact action-authority preflight
      x-source: https://foxify.pro/machine-start
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostActionPreflightRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostActionPreflightResponse'
      x-evidence:
        kind: documentation
  /api/basket/v1/basket/solve:
    post:
      operationId: post_api_basket_v1_basket_solve
      tags:
      - Api
      summary: POST /api/basket/v1/basket/solve
      x-source: https://foxify.pro/developers
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiBasketV1BasketSolveRequest'
      responses:
        '201':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiBasketV1BasketSolveResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl https://foxify.pro/api/basket/v1/basket/solve  -H 'Content-Type: application/json'  --data '{\"problem\":{\"schema\":\"\
          basket-problem/v1\",\"prices_cents\":[[900,800],[800,1200]],\"shipping_cents\":[400,700],\"minimum_order_cents\":[0,0],\"max_suppliers\"\
          :1,\"budget_cents\":2500}}' Request body Copy {\n \"problem\": {\n \"schema\": \"basket-problem/v1\",\n \"prices_cents\": [[900, 800],\
          \ [800, 1200]],\n \"shipping_cents\":"
  /api/basket/v1/basket/verify:
    post:
      operationId: post_api_basket_v1_basket_verify
      tags:
      - Api
      summary: Run the check yourself.
      x-source: https://foxify.pro/developers
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiBasketV1BasketVerifyRequest'
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiBasketV1BasketVerifyResponse'
      x-evidence:
        kind: documentation
  /downloads/agent-authority-check-v1.py:
    get:
      operationId: get_downloads_agent_authority_check_v1_py
      tags:
      - Downloads
      summary: GitHub Action for AI Agent Authority Mapping · FOXIFY
      x-source: https://foxify.pro/github-agent-authority-action
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /example:
    get:
      operationId: get_example
      tags:
      - Example
      summary: Synthetic example problem.
      x-source: https://foxify.pro/api/basket/schema
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /health:
    get:
      operationId: get_health
      tags:
      - Health
      summary: Liveness, not a background-job or real-offer guarantee.
      x-source: https://foxify.pro/api/basket/schema
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /preflight:
    post:
      operationId: post_preflight
      tags:
      - Preflight
      summary: POST /preflight
      x-source: https://foxify.pro/machine-start
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl curl -i -X POST https://x402.foxify.pro/preflight  -H 'content-type: application/json'  --data '{}' \n The empty request\
          \ above is only an unpaid discovery probe. It does not sign or spend anything. \n Exact action-authority preflight · $0.25 USDC \n For\
          \ consequential actions, send the actual subject, tool, operation, exact target, canonical parameters, authority lifetime, retry state\
          \ and require"
  /schema:
    get:
      operationId: get_schema
      tags:
      - Schema
      summary: This contract and the input JSON schema.
      x-source: https://foxify.pro/api/basket/schema
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/basket/solve:
    post:
      operationId: post_v1_basket_solve
      tags:
      - Basket
      summary: Bounded exact search. No charge, purchase or external request.
      x-source: https://foxify.pro/api/basket/schema
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV1BasketSolveRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/basket/verify:
    post:
      operationId: post_v1_basket_verify
      tags:
      - Basket
      summary: Independent feasibility checker, including tampered/foreign input detection.
      x-source: https://foxify.pro/api/basket/schema
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV1BasketVerifyRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
components:
  schemas:
    PostActionPreflightRequest:
      type: object
      properties:
        action_id:
          type: string
        nonce:
          type: string
        expires_at:
          type: string
          description: ISO‑8601 timestamp
        subject:
          type: object
          description: Subject information
        action:
          type: object
          description: Tool, operation, target and parameters
        authority:
          type: object
          description: Authority contract details
        execution:
          type: object
          description: Execution attempt information
        postcondition:
          type: object
          description: Post‑condition requirement
      required:
      - action_id
      - nonce
      - expires_at
      - subject
      - action
      - authority
      - execution
      - postcondition
    PostActionPreflightResponse:
      type: object
      properties:
        '402':
          type: string
          description: Unpaid testing response with payment contract.
        '200':
          type: string
          description: Advisory verdict (ALLOW / REVIEW / DENY) after payment settlement.
    PostApiBasketV1BasketSolveRequest:
      type: object
      properties:
        problem:
          type: object
          properties:
            schema:
              type: string
            prices_cents:
              type: array
              items:
                type: array
                items:
                  type: integer
            shipping_cents:
              type: array
              items:
                type: integer
            minimum_order_cents:
              type: array
              items:
                type: integer
            max_suppliers:
              type: integer
            budget_cents:
              type: integer
    PostApiBasketV1BasketSolveResponse:
      type: object
      properties:
        problem:
          type: object
          properties:
            schema:
              type: string
            prices_cents:
              type: array
              items:
                type: array
                items:
                  type: integer
            shipping_cents:
              type: array
              items:
                type: integer
            minimum_order_cents:
              type: array
              items:
                type: integer
            max_suppliers:
              type: integer
            budget_cents:
              type: integer
    PostApiBasketV1BasketVerifyRequest:
      type: object
      properties:
        problem:
          type: object
          description: Same problem object used for solving.
        receipt:
          type: object
          description: Receipt returned from a previous solve request.
      required:
      - problem
      - receipt
    PostApiBasketV1BasketVerifyResponse:
      type: object
      properties:
        verification:
          type: object
          description: Wraps the check result.
        verification.valid:
          type: boolean
          description: Whether the receipt is valid for the supplied problem.
        verification.errors:
          type: array
          description: List of errors if verification failed.
    PostV1BasketSolveRequest:
      type: object
      properties:
        problem:
          type: string
          description: basket-problem/v1
      required:
      - problem
    PostV1BasketVerifyRequest:
      type: object
      properties:
        problem:
          type: string
          description: basket-problem/v1
        receipt:
          type: object
        receipt.input_sha256:
          type: string
          description: sha256
        receipt.supplier_for_item:
          type: array
          description: supplier index per row
        receipt.total_cents:
          type: integer
      required:
      - problem
      - receipt
      - receipt.input_sha256
      - receipt.supplier_for_item
      - receipt.total_cents
tags:
- name: Action Preflight
- name: Api
- name: Basket
- name: Downloads
- name: Example
- name: Health
- name: Preflight
- name: Schema