Semantic Integrity Gateway

{
  "summary": "Root",
  "description": "Unauthenticated service banner -- lets load balancers / uptime\nchecks / a bare curl to the domain root get a 200 instead of the\nFastAPI-default 404, without exposing anything sensitive.",
  "operationId": "root__get",
  "responses": {
    "200": {
      "description": "Successful Response",
      "content": {
        "application/json": {
          "schema": {
            "additionalProperties": true,
            "type": "object",
            "title": "Response Root  Get"
          }
        }
      }
    }
  }
}

{
  "summary": "Click Redirect",
  "description": "Log the click, then 302 to the real destination.\n\n302 not 301: a permanently-cached redirect means the browser never hits us\nagain and every repeat visit becomes invisible.",
  "operationId": "click_redirect_c__token__get",
  "parameters": [
    {
      "name": "token",
      "in": "path",
      "required": true,
      "schema": {
        "type": "string",
        "title": "Token"
      }
    },
    {
      "name": "d",
      "in": "query",
      "required": false,
      "schema": {
        "type": "string",
        "default": "/",
        "title": "D"
      }
    }
  ],
  "responses": {
    "200": {
      "description": "Successful Response",
      "content": {
        "application/json": {
          "schema": {}
        }
      }
    },
    "422": {
      "description": "Validation Error",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/HTTPValidationError"
          }
        }
      }
    }
  }
}

{
  "summary": "Card Success Page",
  "description": "One-time reveal of the key the webhook minted for a paid session.",
  "operationId": "card_success_page_card_success_get",
  "parameters": [
    {
      "name": "session_id",
      "in": "query",
      "required": false,
      "schema": {
        "type": "string",
        "default": "",
        "title": "Session Id"
      }
    }
  ],
  "responses": {
    "200": {
      "description": "Successful Response",
      "content": {
        "text/html": {
          "schema": {
            "type": "string"
          }
        }
      }
    },
    "422": {
      "description": "Validation Error",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/HTTPValidationError"
          }
        }
      }
    }
  }
}

{
  "summary": "Health",
  "operationId": "health_health_get",
  "responses": {
    "200": {
      "description": "Successful Response",
      "content": {
        "application/json": {
          "schema": {
            "additionalProperties": true,
            "type": "object",
            "title": "Response Health Health Get"
          }
        }
      }
    }
  }
}

{
  "summary": "Privacy",
  "operationId": "privacy_privacy_get",
  "responses": {
    "200": {
      "description": "Successful Response",
      "content": {
        "application/json": {
          "schema": {
            "additionalProperties": true,
            "type": "object",
            "title": "Response Privacy Privacy Get"
          }
        }
      }
    }
  }
}

{
  "summary": "Unsubscribe Page",
  "operationId": "unsubscribe_page_unsubscribe_get",
  "parameters": [
    {
      "name": "e",
      "in": "query",
      "required": false,
      "schema": {
        "type": "string",
        "default": "",
        "title": "E"
      }
    },
    {
      "name": "t",
      "in": "query",
      "required": false,
      "schema": {
        "type": "string",
        "default": "",
        "title": "T"
      }
    }
  ],
  "responses": {
    "200": {
      "description": "Successful Response",
      "content": {
        "text/html": {
          "schema": {
            "type": "string"
          }
        }
      }
    },
    "422": {
      "description": "Validation Error",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/HTTPValidationError"
          }
        }
      }
    }
  }
}

{
  "summary": "Unsubscribe Oneclick",
  "description": "RFC 8058 one-click target. Mail clients POST here with a body of\nList-Unsubscribe=One-Click. Read the raw body rather than using\nfastapi.Form, which hard-requires python-multipart at import time and will\ncrash the whole app on startup if it is absent.\n\nMUST return 2xx even on a bad token -- a non-2xx makes the mail client\nreport a broken unsubscribe, which hurts placement more than the opt-out\nitself costs us.",
  "operationId": "unsubscribe_oneclick_unsubscribe_post",
  "parameters": [
    {
      "name": "e",
      "in": "query",
      "required": false,
      "schema": {
        "type": "string",
        "default": "",
        "title": "E"
      }
    },
    {
      "name": "t",
      "in": "query",
      "required": false,
      "schema": {
        "type": "string",
        "default": "",
        "title": "T"
      }
    }
  ],
  "responses": {
    "200": {
      "description": "Successful Response",
      "content": {
        "application/json": {
          "schema": {}
        }
      }
    },
    "422": {
      "description": "Validation Error",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/HTTPValidationError"
          }
        }
      }
    }
  }
}

{
  "tags": [
    "Free reference tokenizer audit"
  ],
  "summary": "Audit Endpoint",
  "operationId": "audit_endpoint_v1_audit_post",
  "requestBody": {
    "content": {
      "application/json": {
        "schema": {
          "$ref": "#/components/schemas/FreeAuditRequest"
        }
      }
    },
    "required": true
  },
  "responses": {
    "200": {
      "description": "Successful Response",
      "content": {
        "application/json": {
          "schema": {}
        }
      }
    },
    "422": {
      "description": "Validation Error",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/HTTPValidationError"
          }
        }
      }
    }
  }
}

{
  "tags": [
    "Free reference tokenizer audit"
  ],
  "summary": "Audit Stacks",
  "operationId": "audit_stacks_v1_audit_stacks_get",
  "responses": {
    "200": {
      "description": "Successful Response",
      "content": {
        "application/json": {
          "schema": {}
        }
      }
    }
  }
}

{
  "summary": "Create Btc Order",
  "description": "Create a real on-chain BTC invoice: a fresh, never-reused receiving\naddress from our own node, at the live BTC-price-based amount.",
  "operationId": "create_btc_order_v1_checkout_btc_post",
  "requestBody": {
    "content": {
      "application/json": {
        "schema": {
          "$ref": "#/components/schemas/CreateOrderRequest"
        }
      }
    },
    "required": true
  },
  "responses": {
    "200": {
      "description": "Successful Response",
      "content": {
        "application/json": {
          "schema": {
            "additionalProperties": true,
            "type": "object",
            "title": "Response Create Btc Order V1 Checkout Btc Post"
          }
        }
      }
    },
    "422": {
      "description": "Validation Error",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/HTTPValidationError"
          }
        }
      }
    }
  }
}

{
  "summary": "Check Btc Order",
  "operationId": "check_btc_order_v1_checkout_btc__order_id__get",
  "parameters": [
    {
      "name": "order_id",
      "in": "path",
      "required": true,
      "schema": {
        "type": "string",
        "title": "Order Id"
      }
    }
  ],
  "responses": {
    "200": {
      "description": "Successful Response",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "additionalProperties": true,
            "title": "Response Check Btc Order V1 Checkout Btc  Order Id  Get"
          }
        }
      }
    },
    "422": {
      "description": "Validation Error",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/HTTPValidationError"
          }
        }
      }
    }
  }
}

{
  "summary": "Btc Order Qr",
  "description": "Scannable QR for an existing order, as inline-able SVG.\n\nEncodes a BIP-21 URI so any wallet prefills BOTH address and amount --\na customer who scans this cannot underpay by mistyping the amount.\n\nThe scheme is deliberately LOWERCASE (\"bitcoin:\"): some wallets (Strike\namong them) reject an uppercased URI outright, even though QR alphanumeric\nmode would compress better with uppercase. Correctness over density.",
  "operationId": "btc_order_qr_v1_checkout_btc__order_id__qr_svg_get",
  "parameters": [
    {
      "name": "order_id",
      "in": "path",
      "required": true,
      "schema": {
        "type": "string",
        "title": "Order Id"
      }
    }
  ],
  "responses": {
    "200": {
      "description": "Successful Response",
      "content": {
        "application/json": {
          "schema": {}
        }
      }
    },
    "422": {
      "description": "Validation Error",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/HTTPValidationError"
          }
        }
      }
    }
  }
}

{
  "summary": "Card Status",
  "description": "Is a card/PayPal rail actually live for this tier?\n\nThe frontend uses this to decide between a real checkout button and the\nemail-capture fallback. It reports only what is genuinely configured -- with\nno processor credentials on disk this returns configured=False, which is the\nhonest current state.",
  "operationId": "card_status_v1_checkout_card_status_get",
  "parameters": [
    {
      "name": "tier",
      "in": "query",
      "required": false,
      "schema": {
        "type": "string",
        "default": "growth",
        "title": "Tier"
      }
    }
  ],
  "responses": {
    "200": {
      "description": "Successful Response",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "additionalProperties": true,
            "title": "Response Card Status V1 Checkout Card Status Get"
          }
        }
      }
    },
    "422": {
      "description": "Validation Error",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/HTTPValidationError"
          }
        }
      }
    }
  }
}

{
  "summary": "Card Webhook",
  "description": "Authoritative settlement for the card rail.\n\nSignature verification is MANDATORY (stripe.Webhook.construct_event).\nWithout it anyone could POST a fake checkout.session.completed and mint\nthemselves a paid API key, so a missing secret FAILS CLOSED with 503 --\nit never falls back to trusting the body.\n\nIdempotent by both event id and checkout-session id: Stripe retries until\nit sees a 2xx and an operator can hit \"Resend\", so a replay must return\n200 without issuing a second key.",
  "operationId": "card_webhook_v1_checkout_card_webhook_post",
  "responses": {
    "200": {
      "description": "Successful Response",
      "content": {
        "application/json": {
          "schema": {
            "additionalProperties": true,
            "type": "object",
            "title": "Response Card Webhook V1 Checkout Card Webhook Post"
          }
        }
      }
    }
  }
}

{
  "summary": "Card Webhook Status",
  "description": "Secret-free report of whether card settlement can actually run.",
  "operationId": "card_webhook_status_v1_checkout_card_webhook_status_get",
  "responses": {
    "200": {
      "description": "Successful Response",
      "content": {
        "application/json": {
          "schema": {
            "additionalProperties": true,
            "type": "object",
            "title": "Response Card Webhook Status V1 Checkout Card Webhook Status Get"
          }
        }
      }
    }
  }
}

{
  "summary": "Check Card Order",
  "description": "Success-page pickup for a card order.\n\nThe webhook is authoritative but its response goes to STRIPE, not to the\nbuyer -- and api_keys only persists the hash. So the raw key is parked for\nexactly ONE retrieval here. Without this the paying customer sees a\nsuccess page with no credential.",
  "operationId": "check_card_order_v1_checkout_card__session_id__get",
  "parameters": [
    {
      "name": "session_id",
      "in": "path",
      "required": true,
      "schema": {
        "type": "string",
        "title": "Session Id"
      }
    }
  ],
  "responses": {
    "200": {
      "description": "Successful Response",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "additionalProperties": true,
            "title": "Response Check Card Order V1 Checkout Card  Session Id  Get"
          }
        }
      }
    },
    "422": {
      "description": "Validation Error",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/HTTPValidationError"
          }
        }
      }
    }
  }
}

{
  "summary": "Create Lightning Order",
  "description": "Mint a real mainnet BOLT11 invoice for the requested tier.",
  "operationId": "create_lightning_order_v1_checkout_lightning_post",
  "requestBody": {
    "content": {
      "application/json": {
        "schema": {
          "$ref": "#/components/schemas/CreateOrderRequest"
        }
      }
    },
    "required": true
  },
  "responses": {
    "200": {
      "description": "Successful Response",
      "content": {
        "application/json": {
          "schema": {
            "additionalProperties": true,
            "type": "object",
            "title": "Response Create Lightning Order V1 Checkout Lightning Post"
          }
        }
      }
    },
    "422": {
      "description": "Validation Error",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/HTTPValidationError"
          }
        }
      }
    }
  }
}

{
  "summary": "Lightning Capacity",
  "description": "Report whether Lightning can actually receive a given tier RIGHT NOW.\n\nThe frontend calls this before showing the Lightning option, so a customer\nis never offered a rail that will fail on click. Inbound liquidity is a\nlive property of the node, not a static config value.",
  "operationId": "lightning_capacity_v1_checkout_lightning_capacity_get",
  "responses": {
    "200": {
      "description": "Successful Response",
      "content": {
        "application/json": {
          "schema": {
            "additionalProperties": true,
            "type": "object",
            "title": "Response Lightning Capacity V1 Checkout Lightning Capacity Get"
          }
        }
      }
    }
  }
}

{
  "summary": "Check Lightning Order",
  "description": "Poll settle state. Issues the API key exactly once, on first settle.",
  "operationId": "check_lightning_order_v1_checkout_lightning__payment_hash__get",
  "parameters": [
    {
      "name": "payment_hash",
      "in": "path",
      "required": true,
      "schema": {
        "type": "string",
        "title": "Payment Hash"
      }
    }
  ],
  "responses": {
    "200": {
      "description": "Successful Response",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "additionalProperties": true,
            "title": "Response Check Lightning Order V1 Checkout Lightning  Payment Hash  Get"
          }
        }
      }
    },
    "422": {
      "description": "Validation Error",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/HTTPValidationError"
          }
        }
      }
    }
  }
}

{
  "summary": "Lightning Order Qr",
  "description": "Scannable QR for a Lightning invoice.\n\nThe BOLT11 string already encodes the amount, so there is no underpayment\nrisk. Scheme is lowercase \"lightning:\" -- Strike (and others) reject an\nuppercased URI, so we take the QR size hit rather than break wallets.",
  "operationId": "lightning_order_qr_v1_checkout_lightning__payment_hash__qr_svg_get",
  "parameters": [
    {
      "name": "payment_hash",
      "in": "path",
      "required": true,
      "schema": {
        "type": "string",
        "title": "Payment Hash"
      }
    }
  ],
  "responses": {
    "200": {
      "description": "Successful Response",
      "content": {
        "application/json": {
          "schema": {}
        }
      }
    },
    "422": {
      "description": "Validation Error",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/HTTPValidationError"
          }
        }
      }
    }
  }
}

{
  "summary": "Delivery Interest Endpoint",
  "description": "Record which enterprise delivery model a buyer wants.\n\nHONEST BY CONSTRUCTION:\n  * Issues no API key and starts no provisioning.\n  * Returns no order id, no invoice, no download link, because none exist.\n  * Persists append-only to disk so a lead is never silently dropped just\n    because no CRM/email service is wired up yet.\n  * The response `next_step` says a human will reply -- it never claims an\n    automated fulfilment that does not exist.",
  "operationId": "delivery_interest_endpoint_v1_delivery_interest_post",
  "requestBody": {
    "content": {
      "application/json": {
        "schema": {
          "$ref": "#/components/schemas/DeliveryInterestRequest"
        }
      }
    },
    "required": true
  },
  "responses": {
    "200": {
      "description": "Successful Response",
      "content": {
        "application/json": {
          "schema": {
            "additionalProperties": true,
            "type": "object",
            "title": "Response Delivery Interest Endpoint V1 Delivery Interest Post"
          }
        }
      }
    },
    "422": {
      "description": "Validation Error",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/HTTPValidationError"
          }
        }
      }
    }
  }
}

{
  "summary": "Delivery Models Endpoint",
  "description": "Public, unauthenticated: the three ENTERPRISE software-delivery models.\n\nThis is a catalogue, not a store. Every entry carries\navailability='by_agreement_scoped', self_service=False and\nprice_is_indicative=True, so no client can mistake it for a purchasable\nSKU. Nothing here is provisioned by this API -- the companion\nPOST /v1/delivery-interest exists purely so a buyer can TELL US which\nmodel they want, and a human follows up.",
  "operationId": "delivery_models_endpoint_v1_delivery_models_get",
  "responses": {
    "200": {
      "description": "Successful Response",
      "content": {
        "application/json": {
          "schema": {
            "additionalProperties": true,
            "type": "object",
            "title": "Response Delivery Models Endpoint V1 Delivery Models Get"
          }
        }
      }
    }
  }
}

{
  "summary": "Fuse Endpoint",
  "operationId": "fuse_endpoint_v1_fuse_post",
  "parameters": [
    {
      "name": "X-API-Key",
      "in": "header",
      "required": false,
      "schema": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "X-Api-Key"
      }
    }
  ],
  "requestBody": {
    "required": true,
    "content": {
      "application/json": {
        "schema": {
          "$ref": "#/components/schemas/FuseRequest"
        }
      }
    }
  },
  "responses": {
    "200": {
      "description": "Successful Response",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/FuseResponse"
          }
        }
      }
    },
    "422": {
      "description": "Validation Error",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/HTTPValidationError"
          }
        }
      }
    }
  }
}

{
  "summary": "Leads Endpoint",
  "description": "Public, unauthenticated lead capture for the landing page CTA. No\nexternal email service is wired up yet, so this durably persists the\nlead to disk (append-only JSONL) rather than silently discarding it or\npretending an email was sent that wasn't.",
  "operationId": "leads_endpoint_v1_leads_post",
  "requestBody": {
    "content": {
      "application/json": {
        "schema": {
          "$ref": "#/components/schemas/LeadRequest"
        }
      }
    },
    "required": true
  },
  "responses": {
    "200": {
      "description": "Successful Response",
      "content": {
        "application/json": {
          "schema": {
            "additionalProperties": true,
            "type": "object",
            "title": "Response Leads Endpoint V1 Leads Post"
          }
        }
      }
    },
    "422": {
      "description": "Validation Error",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/HTTPValidationError"
          }
        }
      }
    }
  }
}

{
  "summary": "Normalize",
  "operationId": "normalize_v1_normalize_post",
  "parameters": [
    {
      "name": "X-API-Key",
      "in": "header",
      "required": false,
      "schema": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "X-Api-Key"
      }
    }
  ],
  "requestBody": {
    "required": true,
    "content": {
      "application/json": {
        "schema": {
          "$ref": "#/components/schemas/NormalizeRequest"
        }
      }
    }
  },
  "responses": {
    "200": {
      "description": "Successful Response",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "additionalProperties": true,
            "title": "Response Normalize V1 Normalize Post"
          }
        }
      }
    },
    "422": {
      "description": "Validation Error",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/HTTPValidationError"
          }
        }
      }
    }
  }
}

{
  "summary": "Pricing Endpoint",
  "description": "Public, unauthenticated: current tier prices. BTC price is the base\nprice; the response reports the current fiat/credit-card surcharge.",
  "operationId": "pricing_endpoint_v1_pricing_get",
  "responses": {
    "200": {
      "description": "Successful Response",
      "content": {
        "application/json": {
          "schema": {
            "additionalProperties": true,
            "type": "object",
            "title": "Response Pricing Endpoint V1 Pricing Get"
          }
        }
      }
    }
  }
}

{
  "summary": "Quote Endpoint",
  "description": "Public, unauthenticated: build a payment quote for a tier+currency.\nNever claims a payment path is ready unless it actually is -- see\npricing.py docstring.",
  "operationId": "quote_endpoint_v1_quote_post",
  "requestBody": {
    "content": {
      "application/json": {
        "schema": {
          "$ref": "#/components/schemas/QuoteRequest"
        }
      }
    },
    "required": true
  },
  "responses": {
    "200": {
      "description": "Successful Response",
      "content": {
        "application/json": {
          "schema": {
            "additionalProperties": true,
            "type": "object",
            "title": "Response Quote Endpoint V1 Quote Post"
          }
        }
      }
    },
    "422": {
      "description": "Validation Error",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/HTTPValidationError"
          }
        }
      }
    }
  }
}

{
  "summary": "Version",
  "operationId": "version_version_get",
  "responses": {
    "200": {
      "description": "Successful Response",
      "content": {
        "application/json": {
          "schema": {
            "additionalProperties": {
              "type": "string"
            },
            "type": "object",
            "title": "Response Version Version Get"
          }
        }
      }
    }
  }
}