{
  "components": {
    "securitySchemes": {
      "PaymentSignature": {
        "description": "Signed x402 payment payload header used for facilitator verification on paid ResultRail endpoints.",
        "in": "header",
        "name": "PAYMENT-SIGNATURE",
        "type": "apiKey"
      },
      "X402Payment": {
        "description": "Payment payload header accepted by paid endpoints. Local/demo runs may accept `stub-paid-demo` only when explicitly enabled; production does not treat the stub as settlement.",
        "in": "header",
        "name": "X-PAYMENT",
        "type": "apiKey"
      }
    }
  },
  "externalDocs": {
    "description": "ResultRail product card",
    "url": "https://proofbeforepay.vercel.app/resultrail/product-card.md"
  },
  "info": {
    "description": "ResultRail returns public-data result packs with source URLs, timestamps, confidence, and receipt hashes. It does not sell private contact databases, bypass access controls, provide legal/financial advice, send outreach, place bets, trade assets, or guarantee downstream revenue.",
    "summary": "Pay-per-success public data result API for AI agents.",
    "title": "ResultRail by LarryBuildsAI",
    "version": "0.1.0"
  },
  "openapi": "3.1.0",
  "paths": {
    "/.well-known/resultrail-mcp.json": {
      "get": {
        "summary": "ResultRail well-known MCP discovery metadata",
        "tags": [
          "ResultRail Discovery"
        ]
      }
    },
    "/.well-known/resultrail-x402": {
      "get": {
        "summary": "ResultRail x402 manifest",
        "tags": [
          "ResultRail Discovery"
        ]
      }
    },
    "/resultrail": {
      "get": {
        "summary": "ResultRail product page",
        "tags": [
          "ResultRail Discovery"
        ]
      }
    },
    "/resultrail/.well-known/mcp/server-card.json": {
      "get": {
        "summary": "ResultRail MCP server card",
        "tags": [
          "ResultRail Discovery"
        ]
      }
    },
    "/resultrail/agents.txt": {
      "get": {
        "summary": "ResultRail agent discovery file",
        "tags": [
          "ResultRail Discovery"
        ]
      }
    },
    "/resultrail/llms.txt": {
      "get": {
        "summary": "ResultRail LLM discovery file",
        "tags": [
          "ResultRail Discovery"
        ]
      }
    },
    "/resultrail/marketplaces.json": {
      "get": {
        "summary": "ResultRail marketplace distribution metadata",
        "tags": [
          "ResultRail Discovery"
        ]
      }
    },
    "/resultrail/mcp": {
      "get": {
        "summary": "ResultRail MCP publisher metadata",
        "tags": [
          "ResultRail MCP"
        ]
      },
      "post": {
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "MCP JSON-RPC response"
          },
          "402": {
            "description": "x402 payment required for paid tools"
          }
        },
        "summary": "ResultRail MCP JSON-RPC endpoint",
        "tags": [
          "ResultRail MCP"
        ]
      }
    },
    "/resultrail/openapi.json": {
      "get": {
        "summary": "ResultRail OpenAPI document",
        "tags": [
          "ResultRail Discovery"
        ]
      }
    },
    "/resultrail/product-card.md": {
      "get": {
        "summary": "ResultRail product card",
        "tags": [
          "ResultRail Discovery"
        ]
      }
    },
    "/resultrail/proof": {
      "get": {
        "summary": "ResultRail proof and result-contract page",
        "tags": [
          "ResultRail Discovery"
        ]
      }
    },
    "/resultrail/skill.md": {
      "get": {
        "summary": "ResultRail skill card",
        "tags": [
          "ResultRail Discovery"
        ]
      }
    },
    "/v1/resultrail/domain": {
      "post": {
        "description": "ResultRail pay-per-success public domain/company result: title, description, industry guess, tech signals, useful paths, sources, confidence, and receipt hashes.",
        "operationId": "enrich_domain_result",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "additionalProperties": true,
                "properties": {
                  "domain": {
                    "type": "string"
                  },
                  "max_price_usdc": {
                    "default": "0.12",
                    "type": "string"
                  },
                  "pii_mode": {
                    "default": "off",
                    "enum": [
                      "off",
                      "none",
                      "public_only"
                    ],
                    "type": "string"
                  },
                  "required_fields": {
                    "items": {
                      "type": "string"
                    },
                    "type": "array"
                  },
                  "url": {
                    "type": "string"
                  }
                },
                "required": [
                  "domain"
                ],
                "type": "object"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Paid ResultRail result with source URLs, confidence, receipt hashes, and x402 payment summary"
          },
          "400": {
            "description": "Invalid request or no billable public result"
          },
          "402": {
            "description": "x402 payment required"
          }
        },
        "security": [
          {
            "PaymentSignature": []
          },
          {
            "X402Payment": []
          }
        ],
        "summary": "Domain Result Pack",
        "tags": [
          "ResultRail"
        ],
        "x-x402-price": {
          "amount": "0.12",
          "asset": "USDC"
        }
      }
    },
    "/v1/resultrail/extract": {
      "post": {
        "description": "ResultRail pay-per-success public URL extraction: title, description, headings, text preview, links, sources, confidence, and receipt hashes.",
        "operationId": "extract_url_result",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "additionalProperties": true,
                "properties": {
                  "max_price_usdc": {
                    "default": "0.05",
                    "type": "string"
                  },
                  "output": {
                    "default": "summary",
                    "enum": [
                      "summary",
                      "markdown",
                      "json"
                    ],
                    "type": "string"
                  },
                  "url": {
                    "type": "string"
                  }
                },
                "required": [
                  "url"
                ],
                "type": "object"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Paid ResultRail result with source URLs, confidence, receipt hashes, and x402 payment summary"
          },
          "400": {
            "description": "Invalid request or no billable public result"
          },
          "402": {
            "description": "x402 payment required"
          }
        },
        "security": [
          {
            "PaymentSignature": []
          },
          {
            "X402Payment": []
          }
        ],
        "summary": "URL Extract Result",
        "tags": [
          "ResultRail"
        ],
        "x-x402-price": {
          "amount": "0.05",
          "asset": "USDC"
        }
      }
    },
    "/v1/resultrail/quote": {
      "post": {
        "description": "Free quote so agents can inspect price, contract, and success boundary before any x402 payment.",
        "operationId": "quote_data_result",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "additionalProperties": true,
                "properties": {
                  "input": {
                    "type": "string"
                  },
                  "max_price_usdc": {
                    "type": "string"
                  },
                  "task": {
                    "type": "string"
                  },
                  "task_type": {
                    "enum": [
                      "domain",
                      "extract"
                    ],
                    "type": "string"
                  }
                },
                "type": "object"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Free quote, price, success contract, and suggested paid endpoint"
          },
          "400": {
            "description": "Invalid request"
          }
        },
        "summary": "Quote a ResultRail data result before payment",
        "tags": [
          "ResultRail"
        ],
        "x-x402-price": {
          "amount": "0.00",
          "asset": "USDC"
        }
      }
    }
  },
  "servers": [
    {
      "description": "Production",
      "url": "https://proofbeforepay.vercel.app"
    }
  ],
  "tags": [
    {
      "description": "x402-gated public data result endpoints",
      "name": "ResultRail"
    }
  ],
  "x-ai-discovery": {
    "agentsTxt": "https://proofbeforepay.vercel.app/resultrail/agents.txt",
    "canonicalUrl": "https://proofbeforepay.vercel.app/resultrail",
    "llmsTxt": "https://proofbeforepay.vercel.app/resultrail/llms.txt",
    "marketplacesJson": "https://proofbeforepay.vercel.app/resultrail/marketplaces.json",
    "mcpDiscovery": "https://proofbeforepay.vercel.app/.well-known/resultrail-mcp.json",
    "mcpUrl": "https://proofbeforepay.vercel.app/resultrail/mcp",
    "openapi": "https://proofbeforepay.vercel.app/resultrail/openapi.json",
    "productCard": "https://proofbeforepay.vercel.app/resultrail/product-card.md",
    "productIndex": "https://proofbeforepay.vercel.app/ai-discovery.json",
    "proof": "https://proofbeforepay.vercel.app/resultrail/proof",
    "serverCard": "https://proofbeforepay.vercel.app/resultrail/.well-known/mcp/server-card.json",
    "sitemap": "https://proofbeforepay.vercel.app/resultrail/sitemap.xml",
    "skill": "https://proofbeforepay.vercel.app/resultrail/skill.md",
    "x402Manifest": "https://proofbeforepay.vercel.app/.well-known/resultrail-x402"
  },
  "x-canonical-url": "https://proofbeforepay.vercel.app/resultrail",
  "x-resultrail-visibility": {
    "mcpDiscovery": "https://proofbeforepay.vercel.app/.well-known/resultrail-mcp.json",
    "mcpUrl": "https://proofbeforepay.vercel.app/resultrail/mcp",
    "productCard": "https://proofbeforepay.vercel.app/resultrail/product-card.md",
    "searchTerms": [
      "ResultRail",
      "ResultRail by LarryBuildsAI",
      "pay-per-success data",
      "x402 data API",
      "agent data router",
      "agent enrichment API",
      "domain enrichment",
      "URL extraction",
      "public company facts",
      "technographic lookup",
      "no API keys for agents",
      "paid data calls for AI agents"
    ],
    "serverCard": "https://proofbeforepay.vercel.app/resultrail/.well-known/mcp/server-card.json",
    "x402Manifest": "https://proofbeforepay.vercel.app/.well-known/resultrail-x402"
  }
}