{
  "openapi": "3.1.0",
  "info": {
    "title": "Exit.so startups for sale",
    "version": "1.0.0",
    "description": "Live startups for sale on Exit.so, from ideas and ready to launch builds to live and failed startups. Read only, no key needed. See https://exit.so/for-agents"
  },
  "servers": [{ "url": "https://exit.so" }],
  "paths": {
    "/startups.json": {
      "get": {
        "operationId": "searchStartupsForSale",
        "summary": "Search live startups for sale",
        "description": "Returns live listings, newest first. All filters are optional and combine with AND. Amounts are whole US dollars.",
        "parameters": [
          { "name": "category", "in": "query", "schema": { "type": "string", "enum": ["saas", "e-commerce", "fintech", "healthcare", "edtech", "marketplace", "social-consumer", "ai-ml", "developer-tools", "b2b-services", "mobile-apps", "hardware-iot"] } },
          { "name": "status", "in": "query", "description": "Where the startup is now.", "schema": { "type": "string", "enum": ["idea", "in-development", "live", "failed"] } },
          { "name": "revenue", "in": "query", "schema": { "type": "string", "enum": ["pre-revenue", "revenue"] } },
          { "name": "min_ttm", "in": "query", "description": "Minimum revenue over the last 12 months.", "schema": { "type": "integer", "minimum": 0 } },
          { "name": "max_ttm", "in": "query", "description": "Maximum revenue over the last 12 months. Pre-revenue startups count as 0.", "schema": { "type": "integer", "minimum": 0 } },
          { "name": "min_price", "in": "query", "description": "Minimum asking price. Excludes POA listings.", "schema": { "type": "integer", "minimum": 0 } },
          { "name": "max_price", "in": "query", "description": "Maximum asking price. Excludes POA listings.", "schema": { "type": "integer", "minimum": 0 } },
          { "name": "min_users", "in": "query", "description": "Minimum users, matched on the lower bound of the user range.", "schema": { "type": "integer", "minimum": 0 } },
          { "name": "buy_now", "in": "query", "description": "Only listings that can be bought instantly at a fixed price.", "schema": { "type": "boolean" } },
          { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 } }
        ],
        "responses": {
          "200": {
            "description": "Matching listings.",
            "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Feed" } } }
          },
          "400": { "description": "A filter value was not recognised. The error says which values are allowed." }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Feed": {
        "type": "object",
        "properties": {
          "source": { "type": "string" },
          "docs": { "type": "string" },
          "count": { "type": "integer" },
          "listings": { "type": "array", "items": { "$ref": "#/components/schemas/Listing" } }
        }
      },
      "Listing": {
        "type": "object",
        "properties": {
          "name": { "type": "string" },
          "url": { "type": "string", "description": "The listing page, where a buyer can contact the seller or buy." },
          "description": { "type": "string" },
          "category": { "type": "string" },
          "categoryLabel": { "type": "string" },
          "status": { "type": "string", "enum": ["idea", "in-development", "live", "failed"] },
          "revenueStatus": { "type": "string", "enum": ["pre-revenue", "revenue"] },
          "ttmRevenueUsd": { "type": ["integer", "null"], "description": "Revenue over the last 12 months. Null when not given." },
          "users": { "type": ["string", "null"], "description": "A user range such as 1K-5K." },
          "priceType": { "type": "string", "enum": ["price", "buy-now", "poa"] },
          "askingPriceUsd": { "type": ["integer", "null"], "description": "Null for POA, price on application." },
          "includes": { "type": "array", "items": { "type": "string" }, "description": "What transfers with the sale, such as source-code, users, data or domain-name." },
          "reasonForSale": { "type": "string" },
          "website": { "type": "string" },
          "publishedAt": { "type": ["string", "null"], "format": "date-time" },
          "updatedAt": { "type": "string", "format": "date-time" }
        }
      }
    }
  }
}
