{
  "openapi": "3.1.0",
  "info": {
    "title": "GoBuyLeads.com Two-Sided Lead Marketplace & AXO Agent API",
    "version": "1.0.0",
    "description": "Machine-readable REST & Autonomous Agent (AXO) API for GoBuyLeads.com, operated strictly by GETMIB.COM, LLC. Supports public redacted inventory search, Seller Agent SHA-256 Ping/Post ingestion, and Buyer Agent idempotent quoting, purchasing, AutoBuy configuration, and dispute submission.",
    "contact": {
      "name": "GETMIB.COM, LLC API Support",
      "email": "support@gobuyleads.com",
      "url": "https://gobuyleads.com/developers"
    }
  },
  "servers": [
    {
      "url": "https://gobuyleads.com",
      "description": "Production Storefront & API Gateway"
    },
    {
      "url": "https://app.gobuyleads.com",
      "description": "Authenticated Marketplace Workspace"
    }
  ],
  "components": {
    "securitySchemes": {
      "BuyerAgentKey": {
        "type": "http",
        "scheme": "bearer",
        "description": "Scoped Buyer Agent API key prefixed with gbl_buy_"
      },
      "SellerAgentKey": {
        "type": "http",
        "scheme": "bearer",
        "description": "Scoped Seller/Provider Agent API key prefixed with gbl_sell_"
      }
    }
  },
  "paths": {
    "/api/v1/catalog/verticals": {
      "get": {
        "operationId": "listVerticalCatalog",
        "summary": "List all supported lead verticals, pricing floors, and required fields",
        "responses": {
          "200": {
            "description": "Vertical catalog envelope"
          }
        }
      }
    },
    "/api/v1/inventory/search": {
      "get": {
        "operationId": "searchRedactedInventory",
        "summary": "Search published, TCPA-verified lead listings with redacted PII",
        "parameters": [
          {
            "name": "vertical",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "lead_type",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "state",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "availability",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "min_score",
            "in": "query",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Redacted marketplace inventory list and summary counts"
          }
        }
      }
    },
    "/api/v1/policies/compliance": {
      "get": {
        "operationId": "getCompliancePolicies",
        "summary": "Get machine-readable TCPA, 30-day deduplication, and 7-day dispute refund policies",
        "responses": {
          "200": {
            "description": "Compliance and marketplace SLA rules"
          }
        }
      }
    },
    "/api/v1/orders/quote": {
      "post": {
        "operationId": "quoteLeadOrder",
        "summary": "Validate availability, TCPA status, and exact price for an Exclusive or Shared lead purchase",
        "security": [
          {
            "BuyerAgentKey": []
          }
        ],
        "responses": {
          "200": {
            "description": "Order quote with eligibility and spend-cap validation"
          }
        }
      }
    },
    "/api/v1/orders/purchase": {
      "post": {
        "operationId": "purchaseLeadOrder",
        "summary": "Atomically purchase an Exclusive or Shared lead and unlock private contact PII + TCPA proof",
        "security": [
          {
            "BuyerAgentKey": []
          }
        ],
        "responses": {
          "200": {
            "description": "Purchase receipt with unlocked lead_private_data and consent_evidence"
          }
        }
      }
    },
    "/api/v1/orders/{id}": {
      "get": {
        "operationId": "getOrderById",
        "summary": "Fetch a previously purchased lead order and unlocked PII",
        "security": [
          {
            "BuyerAgentKey": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Purchased lead order details"
          }
        }
      }
    },
    "/api/v1/autobuy/rules": {
      "post": {
        "operationId": "createAutoBuyRule",
        "summary": "Create an automated lead buying rule with daily and monthly budget caps",
        "security": [
          {
            "BuyerAgentKey": []
          }
        ],
        "responses": {
          "201": {
            "description": "Created AutoBuy rule"
          }
        }
      }
    },
    "/api/v1/disputes": {
      "get": {
        "operationId": "listLeadDisputes",
        "summary": "List buyer or provider dispute records",
        "security": [
          {
            "BuyerAgentKey": []
          }
        ],
        "responses": {
          "200": {
            "description": "Dispute records list"
          }
        }
      },
      "post": {
        "operationId": "createLeadDispute",
        "summary": "Submit a buyer return dispute within the 7-day protection window",
        "security": [
          {
            "BuyerAgentKey": []
          }
        ],
        "responses": {
          "201": {
            "description": "Created dispute record"
          }
        }
      },
      "patch": {
        "operationId": "resolveLeadDispute",
        "summary": "Admin resolution of a buyer dispute with atomic buyer wallet refund credit and provider escrow reversal",
        "responses": {
          "200": {
            "description": "Resolved dispute and refund transaction receipt"
          }
        }
      }
    },
    "/api/v1/leads/ping": {
      "post": {
        "operationId": "pingLeadDedupe",
        "summary": "Privacy-safe SHA-256 pre-ping to check 30-day duplicate status and estimated provider payout",
        "security": [
          {
            "SellerAgentKey": []
          }
        ],
        "responses": {
          "200": {
            "description": "Ping eligibility and estimated payout response"
          }
        }
      }
    },
    "/api/v1/leads/ingest": {
      "post": {
        "operationId": "ingestProviderLead",
        "summary": "Submit a full lead with 1-to-1 TCPA consent evidence for scoring, deduplication, and publication",
        "security": [
          {
            "SellerAgentKey": []
          }
        ],
        "responses": {
          "201": {
            "description": "Ingested lead status, AI quality score, and listing reference"
          }
        }
      }
    },
    "/api/v1/provider/submissions/{id}": {
      "get": {
        "operationId": "getProviderSubmissionStatus",
        "summary": "Check review, publication, or quarantine status of a submitted lead",
        "security": [
          {
            "SellerAgentKey": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Provider submission status"
          }
        }
      }
    },
    "/api/webhooks/stripe": {
      "post": {
        "operationId": "handleStripeWebhook",
        "summary": "HMAC-signed Stripe webhook endpoint for replay-safe wallet deposits and Connect payouts",
        "responses": {
          "200": {
            "description": "Webhook processed"
          }
        }
      }
    },
    "/api/mcp": {
      "get": {
        "operationId": "getMcpToolsManifest",
        "summary": "List Model Context Protocol (MCP) tools exposed by GoBuyLeads.com",
        "responses": {
          "200": {
            "description": "MCP tool definitions"
          }
        }
      },
      "post": {
        "operationId": "invokeMcpTool",
        "summary": "Invoke a GoBuyLeads.com MCP JSON-RPC 2.0 or direct tool method",
        "responses": {
          "200": {
            "description": "MCP tool execution result"
          }
        }
      }
    },
    "/api/v1/compliance/opt-out": {
      "post": {
        "operationId": "recordTcpaOptOut",
        "summary": "Record an FCC 2026 consumer TCPA consent revocation hash and quarantine unsold matching listings",
        "responses": {
          "201": {
            "description": "Opt-out recorded and matching unsold listings quarantined"
          }
        }
      }
    },
    "/api/v1/wallet/checkout-session": {
      "post": {
        "operationId": "createWalletCheckoutSession",
        "summary": "Create an idempotent Stripe Checkout Session or sandbox deposit for buyer wallet top-up",
        "security": [
          {
            "BuyerAgentKey": []
          }
        ],
        "responses": {
          "201": {
            "description": "Created checkout session and updated wallet receipt"
          }
        }
      }
    },
    "/api/v1/provider/connect-onboard": {
      "post": {
        "operationId": "createProviderConnectOnboarding",
        "summary": "Generate a Stripe Connect Express onboarding link and KYB status for a Lead Provider",
        "security": [
          {
            "SellerAgentKey": []
          }
        ],
        "responses": {
          "200": {
            "description": "Stripe Connect Express onboarding details"
          }
        }
      }
    },
    "/api/v1/provider/payout": {
      "post": {
        "operationId": "requestProviderPayout",
        "summary": "Initiate a provider payout transfer of settled earnings",
        "security": [
          {
            "SellerAgentKey": []
          }
        ],
        "responses": {
          "200": {
            "description": "Provider payout settlement receipt"
          }
        }
      }
    },
    "/api/v1/cron/release-escrow": {
      "post": {
        "operationId": "releaseMaturedProviderEscrow",
        "summary": "Release matured provider earnings older than the 7-day dispute hold window",
        "responses": {
          "200": {
            "description": "Escrow release summary"
          }
        }
      }
    },
    "/api/v1/deliveries/dispatch": {
      "post": {
        "operationId": "dispatchLeadDelivery",
        "summary": "Dispatch or retry HMAC-signed webhook / GoHighLevel LeadConnector v2 delivery for a purchased lead",
        "security": [
          {
            "BuyerAgentKey": []
          }
        ],
        "responses": {
          "200": {
            "description": "Outbound delivery record"
          }
        }
      }
    },
    "/api/health": {
      "get": {
        "operationId": "getHealthCheck",
        "summary": "Platform readiness, entity isolation, and discovery route healthcheck",
        "responses": {
          "200": {
            "description": "Healthcheck payload"
          }
        }
      }
    },
    "/api/markdown": {
      "get": {
        "operationId": "getMarkdownMirror",
        "summary": "Serve clean Markdown mirror for any public route with X-Markdown-Tokens header",
        "parameters": [
          {
            "name": "path",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Clean Markdown document for AI agents and RAG crawlers"
          }
        }
      }
    },
    "/api/a2a": {
      "get": {
        "operationId": "getA2aAgentCard",
        "summary": "Return the Google Agent2Agent (A2A) Agent Card and supported task skills",
        "responses": {
          "200": {
            "description": "A2A Agent Card"
          }
        }
      },
      "post": {
        "operationId": "executeA2aTaskRpc",
        "summary": "Execute a Google A2A JSON-RPC 2.0 task (message/send, tasks/send, tasks/get, tasks/cancel)",
        "responses": {
          "200": {
            "description": "A2A Task JSON-RPC 2.0 response"
          }
        }
      }
    },
    "/api/v1/wallet/withdraw": {
      "post": {
        "operationId": "withdrawUnusedWalletCash",
        "summary": "Self-serve $0-fee withdrawal of unused deposited wallet cash balance to ACH or original card",
        "security": [
          {
            "BuyerAgentKey": []
          }
        ],
        "responses": {
          "200": {
            "description": "Unused wallet cash withdrawal receipt"
          }
        }
      }
    },
    "/api/v1/orders/batch-purchase": {
      "post": {
        "operationId": "executeBatchLeadPurchase",
        "summary": "Atomically purchase multiple lead listings in a single batch (automatic 8% bundle discount on 3+ leads)",
        "security": [
          {
            "BuyerAgentKey": []
          }
        ],
        "responses": {
          "200": {
            "description": "Batch purchase receipt with 8% volume bundle discount and unlocked PII"
          }
        }
      }
    },
    "/api/v1/autobuy/subid-rules": {
      "get": {
        "operationId": "listPublisherSubIdMetrics",
        "summary": "List publisher Sub-ID contact/close metrics and active block/boost rules",
        "security": [
          {
            "BuyerAgentKey": []
          }
        ],
        "responses": {
          "200": {
            "description": "Publisher Sub-ID scorecard and routing rules"
          }
        }
      },
      "post": {
        "operationId": "togglePublisherSubIdRule",
        "summary": "1-click block or boost a specific Publisher Sub-ID across active AutoBuy rules",
        "security": [
          {
            "BuyerAgentKey": []
          }
        ],
        "responses": {
          "200": {
            "description": "Updated Sub-ID block/boost arrays"
          }
        }
      }
    },
    "/api/v1/deliveries/double-tap": {
      "post": {
        "operationId": "triggerDoubleTapSpeedToLeadBridge",
        "summary": "Launch <60s Double-Tap Speed-to-Lead Voice+SMS Bridge with State Mini-TCPA check and 10% instant rebate",
        "security": [
          {
            "BuyerAgentKey": []
          }
        ],
        "responses": {
          "200": {
            "description": "Double-Tap bridge connection status and 10% Speed-to-Lead rebate receipt"
          }
        }
      }
    },
    "/api/v1/provider/factoring": {
      "post": {
        "operationId": "requestDay1SellerFactoring",
        "summary": "Advance pending 7-day provider escrow earnings on Day 1 for a 1.5% instant factoring fee",
        "security": [
          {
            "SellerAgentKey": []
          }
        ],
        "responses": {
          "200": {
            "description": "Day-1 instant payout factoring settlement receipt"
          }
        }
      }
    },
    "/api/v1/cron/retry-deliveries": {
      "post": {
        "operationId": "sweepRetryScheduledDeliveries",
        "summary": "Sweep retry_scheduled outbound CRM deliveries and promote exhausted retries to dead_letter",
        "responses": {
          "200": {
            "description": "Retry sweep summary"
          }
        }
      }
    },
    "/api/v1/dispositions": {
      "get": {
        "operationId": "listBuyerDispositions",
        "summary": "List closed-loop buyer CRM outcome dispositions and telemetry rebates",
        "security": [
          {
            "BuyerAgentKey": []
          }
        ],
        "responses": {
          "200": {
            "description": "Buyer disposition history"
          }
        }
      },
      "post": {
        "operationId": "recordBuyerDisposition",
        "summary": "Record closed-loop CRM outcome writeback, credit $1.00 telemetry rebate, trigger 72h Fair-Shot Disconnected_Invalid auto-refund, and enforce 8% Publisher Sub-ID auto-throttle",
        "security": [
          {
            "BuyerAgentKey": []
          }
        ],
        "responses": {
          "200": {
            "description": "Disposition receipt, rebate credit, and publisher throttle telemetry"
          }
        }
      }
    },
    "/api/v1/suppression": {
      "get": {
        "operationId": "listBuyerSuppressionHashes",
        "summary": "List zero-knowledge SHA-256 phone/email CRM suppression hashes for the active buyer organization",
        "security": [
          {
            "BuyerAgentKey": []
          }
        ],
        "responses": {
          "200": {
            "description": "Active SHA-256 suppression hashes"
          }
        }
      },
      "post": {
        "operationId": "upsertOrCheckBuyerSuppressionHashes",
        "summary": "Upload or check zero-knowledge SHA-256 phone/email CRM suppression hashes to block duplicate leads (ALREADY_IN_BUYER_CRM)",
        "security": [
          {
            "BuyerAgentKey": []
          }
        ],
        "responses": {
          "200": {
            "description": "Suppression upload or check receipt"
          }
        }
      },
      "delete": {
        "operationId": "deleteBuyerSuppressionHash",
        "summary": "Remove a SHA-256 contact hash from the buyer CRM suppression list",
        "security": [
          {
            "BuyerAgentKey": []
          }
        ],
        "responses": {
          "200": {
            "description": "Deletion confirmation"
          }
        }
      }
    },
    "/api/v1/leads/bulk-ingest": {
      "post": {
        "operationId": "bulkIngestProviderLeads",
        "summary": "Batch ingest up to 100 seller leads per request with per-row SHA-256 deduplication, TrustedForm/Jornaya dual-token verification, and litigator hygiene scrub",
        "security": [
          {
            "SellerAgentKey": []
          }
        ],
        "responses": {
          "200": {
            "description": "Batch ingestion summary with accepted and quarantined counts"
          }
        }
      }
    },
    "/api/v1/admin/review-lead": {
      "post": {
        "operationId": "reviewPendingLeadListing",
        "summary": "Admin compliance publish gate approval or rejection for a pending lead listing",
        "responses": {
          "200": {
            "description": "Updated lead listing review status"
          }
        }
      }
    },
    "/api/v1/auction/simulate-bid": {
      "get": {
        "operationId": "simulateBidLandscapeAndScenarioYieldGet",
        "summary": "Simulate bid landscape win-rate and combinatorial Exclusive vs. Shared-Cluster scenario yield",
        "parameters": [
          {
            "name": "vertical_slug",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "state",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "max_cpl",
            "in": "query",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "exclusivity_mode",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Bid landscape simulation and combinatorial scenario yield"
          }
        }
      },
      "post": {
        "operationId": "simulateBidLandscapeAndScenarioYieldPost",
        "summary": "Run combinatorial Exclusive vs. Shared-Cluster scenario auction yield and bid landscape simulation",
        "responses": {
          "200": {
            "description": "Bid landscape simulation and combinatorial scenario yield"
          }
        }
      }
    },
    "/api/v1/team/roster": {
      "get": {
        "operationId": "listBuyerTeamRoster",
        "summary": "List buyer team reps, availability statuses, state licenses, and Saved Lead Streams",
        "security": [
          {
            "BuyerAgentKey": []
          }
        ],
        "responses": {
          "200": {
            "description": "Buyer team roster and saved streams"
          }
        }
      },
      "post": {
        "operationId": "manageBuyerTeamRosterOrAssignLead",
        "summary": "Upsert team rep, assign purchased lead via weighted round-robin, or save a named Lead Stream",
        "security": [
          {
            "BuyerAgentKey": []
          }
        ],
        "responses": {
          "200": {
            "description": "Updated team rep, round-robin assignment, or saved stream"
          }
        }
      },
      "delete": {
        "operationId": "deleteBuyerTeamMemberOrStream",
        "summary": "Delete a buyer team member or saved lead stream",
        "security": [
          {
            "BuyerAgentKey": []
          }
        ],
        "responses": {
          "200": {
            "description": "Deletion confirmation"
          }
        }
      }
    },
    "/api/v1/dispositions/postback": {
      "get": {
        "operationId": "getOrExecuteInboundDispositionPostback",
        "summary": "Generate signed inbound CRM disposition postback URL templates or record disposition via GET query",
        "responses": {
          "200": {
            "description": "Signed postback URL templates or recorded disposition receipt"
          }
        }
      },
      "post": {
        "operationId": "postInboundCrmDispositionWebhook",
        "summary": "Zero-code inbound CRM postback webhook crediting $1.00 telemetry rebate and enforcing 8% Sub-ID auto-throttle",
        "responses": {
          "200": {
            "description": "Disposition receipt and $1.00 telemetry rebate confirmation"
          }
        }
      }
    },
    "/api/v1/leads/call-script": {
      "get": {
        "operationId": "generateLeadCallScriptGet",
        "summary": "Generate tailored AI Cold-to-Close Call Script, 3-objection playbook, and 5-touch SMS cadence",
        "parameters": [
          {
            "name": "listing_id",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Tailored call script and SMS cadence"
          }
        }
      },
      "post": {
        "operationId": "generateCallScriptOrCompareLeads",
        "summary": "Generate AI Cold-to-Close Call Script or run side-by-side multi-lead comparison with best-value recommendation",
        "responses": {
          "200": {
            "description": "Call script or side-by-side lead comparison matrix"
          }
        }
      }
    },
    "/api/v1/x402/challenge": {
      "get": {
        "operationId": "issueX402MachineSettlementChallenge",
        "summary": "Issue an HTTP 402 (x402/1.0) machine-to-machine payment challenge for a lead listing",
        "parameters": [
          {
            "name": "listing_id",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "purchase_mode",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "x402/1.0 payment challenge headers and descriptor"
          },
          "402": {
            "description": "HTTP 402 Payment Required machine challenge"
          }
        }
      },
      "post": {
        "operationId": "verifyX402MachineSettlementReceipt",
        "summary": "Verify an x402/1.0 machine settlement receipt and atomically credit wallet + unlock lead PII",
        "responses": {
          "200": {
            "description": "Verified x402 settlement receipt and unlocked purchase"
          }
        }
      }
    },
    "/api/v1/seo/indexnow": {
      "get": {
        "operationId": "getIndexNowPushStatus",
        "summary": "Retrieve IndexNow/1.0 protocol key and submit canonical + programmatic Geo-SEO URLs to Bing, Yandex, and AI answer engines",
        "responses": {
          "200": {
            "description": "IndexNow submission receipt and URL manifest"
          }
        }
      },
      "post": {
        "operationId": "submitIndexNowUrls",
        "summary": "Push updated vertical and state programmatic Geo-SEO URLs via IndexNow/1.0",
        "responses": {
          "200": {
            "description": "IndexNow submission receipt"
          }
        }
      }
    },
    "/api/v1/alerts/subscriptions": {
      "get": {
        "operationId": "listBuyerAlertSubscriptions",
        "summary": "List multi-channel Buyer Lead Alert Subscriptions (Slack Block Kit, Microsoft Teams Adaptive Card, SMS, Webhook, Email)",
        "security": [
          {
            "BuyerAgentKey": []
          }
        ],
        "responses": {
          "200": {
            "description": "Active alert subscriptions and sample channel payload"
          }
        }
      },
      "post": {
        "operationId": "upsertOrEvaluateBuyerAlertSubscription",
        "summary": "Create/update a multi-channel Buyer Alert Subscription or evaluate real-time lead alert fanout",
        "security": [
          {
            "BuyerAgentKey": []
          }
        ],
        "responses": {
          "200": {
            "description": "Saved alert subscription or fanout evaluation result"
          }
        }
      },
      "delete": {
        "operationId": "deleteBuyerAlertSubscription",
        "summary": "Delete a Buyer Lead Alert Subscription",
        "security": [
          {
            "BuyerAgentKey": []
          }
        ],
        "responses": {
          "200": {
            "description": "Deletion confirmation"
          }
        }
      }
    },
    "/api/v1/analytics/cohorts": {
      "get": {
        "operationId": "getCohortRoasAttributionGet",
        "summary": "Retrieve Closed-Loop Publisher Sub-ID & State Cohort ROAS Attribution Matrix",
        "security": [
          {
            "BuyerAgentKey": []
          }
        ],
        "parameters": [
          {
            "name": "vertical_slug",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "state",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Cohort ROAS attribution report by publisher_sub_id, vertical_slug, and state"
          }
        }
      },
      "post": {
        "operationId": "getCohortRoasAttributionPost",
        "summary": "Compute Closed-Loop Publisher Sub-ID & State Cohort ROAS Attribution Matrix",
        "security": [
          {
            "BuyerAgentKey": []
          }
        ],
        "responses": {
          "200": {
            "description": "Cohort ROAS attribution report"
          }
        }
      }
    },
    "/api/v1/leads/waterfall-cascade": {
      "get": {
        "operationId": "listWaterfallCascadeEvents",
        "summary": "List Automated Seller Yield Waterfall Cascade Events (Exclusive -> Shared Cluster -> Encore Vault)",
        "responses": {
          "200": {
            "description": "Waterfall cascade event ledger"
          }
        }
      },
      "post": {
        "operationId": "executeWaterfallCascade",
        "summary": "Execute Automated Seller Yield Waterfall Stage Cascade",
        "security": [
          {
            "SellerAgentKey": []
          },
          {
            "BuyerAgentKey": []
          }
        ],
        "responses": {
          "200": {
            "description": "Waterfall stage transition receipt"
          }
        }
      }
    },
    "/api/v1/disputes/precheck": {
      "get": {
        "operationId": "listCarrierHlrChecks",
        "summary": "List or Run Cryptographic Carrier HLR / Line-Status & 72h Fair-Shot Pre-Checks",
        "security": [
          {
            "BuyerAgentKey": []
          }
        ],
        "responses": {
          "200": {
            "description": "Carrier HLR line status check receipt or list"
          }
        }
      },
      "post": {
        "operationId": "verifyCarrierLineStatus",
        "summary": "Run Cryptographic Carrier HLR / Line-Status & Litigator Watchlist Pre-Check",
        "security": [
          {
            "BuyerAgentKey": []
          }
        ],
        "responses": {
          "200": {
            "description": "Carrier HLR verification receipt with 72h Fair-Shot auto-credit eligibility"
          }
        }
      }
    },
    "/api/v1/deliveries/transform-preview": {
      "get": {
        "operationId": "previewCrmPayloadTransformGet",
        "summary": "Preview Transformed CRM or Ping-Post Payload with Live HMAC-SHA256 Signature",
        "responses": {
          "200": {
            "description": "Transformed CRM payload preview"
          }
        }
      },
      "post": {
        "operationId": "previewCrmPayloadTransformPost",
        "summary": "Transform Canonical GoBuyLeads Payload into GHL, HubSpot, Salesforce, Follow Up Boss, Arive MISMO 3.4, Clio, Boberdoo, Leadspedia, or Phonexa Schema",
        "responses": {
          "200": {
            "description": "Transformed CRM payload preview with X-GoBuyLeads-Signature HMAC header"
          }
        }
      }
    },
    "/api/v1/compliance/litigator-scrub": {
      "get": {
        "operationId": "listOrScrubLitigatorFirewallGet",
        "summary": "List or Execute Real-Time SHA-256 Serial TCPA Litigator, Federal/State DNC & Revocation Firewall Scrubs",
        "responses": {
          "200": {
            "description": "Litigator & DNC firewall scrub logs or verdict"
          }
        }
      },
      "post": {
        "operationId": "evaluateLitigatorDncFirewallPost",
        "summary": "Execute Real-Time SHA-256 Serial TCPA Litigator, DNC & Revocation Firewall Screening",
        "responses": {
          "200": {
            "description": "Litigator firewall verdict and statutory risk score (0-100)"
          }
        }
      }
    },
    "/api/v1/provider/escrow-ledger": {
      "get": {
        "operationId": "listProviderEscrowSettlements",
        "summary": "List 72-Hour Provider Escrow Holds and Instant Factoring Settlements",
        "responses": {
          "200": {
            "description": "Provider escrow settlement ledger"
          }
        }
      },
      "post": {
        "operationId": "settleProviderEscrow",
        "summary": "Settle a 72-Hour Provider Escrow Hold via 97.5% Instant Factoring Advance, T+3 Release, or Dispute Clawback",
        "responses": {
          "200": {
            "description": "Provider escrow settlement receipt"
          }
        }
      }
    },
    "/api/v1/leads/warm-transfer": {
      "get": {
        "operationId": "listWarmTransferSessions",
        "summary": "List Live IVR Whisper Warm-Transfer Call Sessions & 90s Billable Buffer Telemetry",
        "responses": {
          "200": {
            "description": "Warm-Transfer session ledger"
          }
        }
      },
      "post": {
        "operationId": "recordWarmTransferSession",
        "summary": "Simulate and Settle a Live IVR Whisper Warm-Transfer Call Session Enforcing the 90s Billable Buffer ($0 Charge < 90s)",
        "responses": {
          "200": {
            "description": "Warm-Transfer call settlement receipt"
          }
        }
      }
    },
    "/api/v1/compliance/fcc-rnd-check": {
      "get": {
        "operationId": "listOrVerifyFccRndSafeHarborGet",
        "summary": "List or Execute 47 CFR § 64.1200(m) FCC Reassigned Numbers Database (RND) Safe-Harbor Verifications",
        "responses": {
          "200": {
            "description": "FCC RND Safe Harbor verification ledger or check receipt"
          }
        }
      },
      "post": {
        "operationId": "verifyFccRndSafeHarborPost",
        "summary": "Verify FCC Reassigned Numbers Database (RND) Safe-Harbor Qualification Comparing Consent Timestamp Against Last Disconnect Date",
        "responses": {
          "200": {
            "description": "FCC RND Safe Harbor verification receipt"
          }
        }
      }
    },
    "/api/v1/orders/limit-book": {
      "get": {
        "operationId": "listStandingLimitOrders",
        "summary": "List Good-Til-Cancelled (GTC) Institutional Standing Limit Orders & Forward Volume Contracts",
        "responses": {
          "200": {
            "description": "Standing limit order book and reserved escrow summary"
          }
        }
      },
      "post": {
        "operationId": "placeStandingLimitOrder",
        "summary": "Place an Institutional Standing Limit Order & Forward Volume Contract with Escrow Reservation",
        "responses": {
          "200": {
            "description": "Created standing limit order receipt"
          }
        }
      }
    },
    "/api/v1/ping-post/trace": {
      "get": {
        "operationId": "listOrExecutePingTreeAuctionTracesGet",
        "summary": "List or Execute Multi-Hop OpenRTB 2.6 Ping-Tree Auction Decision Traces",
        "responses": {
          "200": {
            "description": "Ping-Tree auction decision traces with hop-by-hop bidder pruning"
          }
        }
      },
      "post": {
        "operationId": "executePingTreeAuctionTracePost",
        "summary": "Execute a Multi-Hop OpenRTB 2.6 Ping-Tree Auction Decision Trace",
        "responses": {
          "200": {
            "description": "Hop-by-hop Ping-Tree auction decision trace receipt"
          }
        }
      }
    },
    "/api/v1/underwriting/assessor-avm": {
      "get": {
        "operationId": "listOrVerifyPropertyAssessorAvmGet",
        "summary": "List or Execute County Assessor APN & Dual-AVM Property Equity Underwriting Verifications",
        "responses": {
          "200": {
            "description": "County Assessor & Dual-AVM property equity verification ledger or receipt"
          }
        }
      },
      "post": {
        "operationId": "verifyPropertyAssessorAvmPost",
        "summary": "Verify County Assessor APN & Dual-AVM Property Equity, Owner-of-Record Match, and Estimated LTV%",
        "responses": {
          "200": {
            "description": "County Assessor & Dual-AVM property equity verification receipt"
          }
        }
      }
    },
    "/api/v1/disputes/arbitrate": {
      "get": {
        "operationId": "listOrArbitrateBuyerDisputeGet",
        "summary": "List or Execute Autonomous <3s AI Dispute Arbitration Rulings & Instant Wallet Credits",
        "responses": {
          "200": {
            "description": "Autonomous dispute arbitration ledger or ruling receipt"
          }
        }
      },
      "post": {
        "operationId": "arbitrateBuyerDisputePost",
        "summary": "Run Autonomous <3s AI Dispute Arbitration Checking Carrier HLR, FCC RND, TCPA Hash Proof & Call Duration",
        "responses": {
          "200": {
            "description": "Autonomous dispute arbitration ruling and instant wallet credit receipt"
          }
        }
      }
    },
    "/api/v1/ping-post/zk-token": {
      "get": {
        "operationId": "listOrIssueZkPingBidTokensGet",
        "summary": "List or Mint Zero-Knowledge Host-and-Post Ping Bid Tokens (HMAC-SHA256)",
        "responses": {
          "200": {
            "description": "Zero-Knowledge Ping Bid Token ledger or minted token receipt"
          }
        }
      },
      "post": {
        "operationId": "issueZkPingBidTokenPost",
        "summary": "Mint a 120-Second Zero-Knowledge Host-and-Post Ping Bid Token Locking Bid Floor & 1-to-1 Buyer Disclosures",
        "responses": {
          "200": {
            "description": "Minted Zero-Knowledge Ping Bid Token receipt"
          }
        }
      }
    },
    "/api/v1/telephony/stir-shaken": {
      "get": {
        "operationId": "listStirShakenCallerIdsGet",
        "summary": "List FCC STIR/SHAKEN Attestation-A & Branded CNAM Caller ID Registry Records",
        "responses": {
          "200": {
            "description": "STIR/SHAKEN Caller ID registry list"
          }
        }
      },
      "post": {
        "operationId": "verifyStirShakenAttestationPost",
        "summary": "Verify and Register an Outbound Dialing DID in the FCC STIR/SHAKEN Attestation-A & Branded CNAM Registry",
        "responses": {
          "200": {
            "description": "Verified STIR/SHAKEN Caller ID attestation receipt"
          }
        }
      }
    },
    "/api/v1/autobuy/bid-modifiers": {
      "get": {
        "operationId": "listDynamicBidModifiersGet",
        "summary": "List Institutional Dayparting, Credit-Tier & Equity-Spread Dynamic Bid-Modifier Matrix Rules",
        "responses": {
          "200": {
            "description": "Dynamic bid-modifier matrix rules list"
          }
        }
      },
      "post": {
        "operationId": "evaluateDynamicBidModifierPost",
        "summary": "Evaluate an Institutional Dayparting & Equity-Spread Dynamic Bid-Modifier Rule (0.50x to 2.00x Multiplier)",
        "responses": {
          "200": {
            "description": "Evaluated dynamic bid-modifier rule and effective auction bid receipt"
          }
        }
      }
    },
    "/api/v1/marketplace/encore-resale": {
      "get": {
        "operationId": "listSecondaryEncoreResalesGet",
        "summary": "List Secondary Market Encore Vault (65% Aged Markdown) Resale Transactions",
        "responses": {
          "200": {
            "description": "Secondary Encore Vault resale ledger"
          }
        }
      },
      "post": {
        "operationId": "executeSecondaryEncoreResalePost",
        "summary": "Execute an Atomic Secondary Market Encore Vault (65% Aged Markdown) Resale with 80/20 Seller Royalty Split",
        "responses": {
          "200": {
            "description": "Executed Secondary Encore Vault resale settlement receipt"
          }
        }
      }
    },
    "/api/v1/compliance/burn-certificate": {
      "get": {
        "operationId": "listExclusivityBurnCertificatesGet",
        "summary": "List Cryptographic Proof-of-Burn Exclusivity Certificates (SHA-256 Merkle Burn Hash & 30-Day Resale Lock)",
        "responses": {
          "200": {
            "description": "Cryptographic Proof-of-Burn Exclusivity Certificate ledger"
          }
        }
      },
      "post": {
        "operationId": "issueExclusivityBurnCertificatePost",
        "summary": "Issue a Cryptographic Proof-of-Burn Exclusivity Certificate Destroying Remaining Shared Seats",
        "responses": {
          "200": {
            "description": "Issued Proof-of-Burn Exclusivity Certificate receipt"
          }
        }
      }
    },
    "/api/v1/underwriting/credit-tier": {
      "get": {
        "operationId": "listCreditTierAttestationsGet",
        "summary": "List FCRA-Exempt Zero-PII Soft-Pull Credit-Tier & DSCR Liquidity Band Attestations",
        "responses": {
          "200": {
            "description": "Zero-PII Soft-Pull Credit-Tier Attestation ledger"
          }
        }
      },
      "post": {
        "operationId": "verifyCreditTierAttestationPost",
        "summary": "Verify an FCRA-Exempt Zero-PII Soft-Pull Credit-Tier & DSCR Liquidity Band Attestation",
        "responses": {
          "200": {
            "description": "Verified Credit-Tier & DSCR Liquidity Band Attestation receipt"
          }
        }
      }
    },
    "/api/v1/orders/dark-pool": {
      "get": {
        "operationId": "listDarkPoolBlockTradesGet",
        "summary": "List Institutional Dark-Pool Block Trades & Bulk Allocation Orders",
        "responses": {
          "200": {
            "description": "Dark-Pool block trade ledger"
          }
        }
      },
      "post": {
        "operationId": "executeDarkPoolBlockTradePost",
        "summary": "Execute an Institutional Dark-Pool Block Trade (10-500 Leads, 5-18% Tiered Volume Discount, 80/20 Split)",
        "responses": {
          "200": {
            "description": "Executed Dark-Pool block trade settlement receipt"
          }
        }
      }
    }
  }
}