{"openapi":"3.1.0","info":{"title":"DealRoom.so SBA Intelligence API","version":"1.1.0","description":"Free, public, read-only API over DealRoom.so SBA deal, lender, franchise, risk, and buyer-prequalification intelligence: 374,000+ public loan records (FY2020–present), 1,000+ lender records enriched with FDIC financials, 3,400+ franchise financing records, and cohort failure rates by brand, industry, state, and bank. Every data response is wrapped in a standard envelope — ok, canonical_url, api_url, data_freshness, methodology, source_summary, results, caveats, citation — so agents can cite and explain results consistently. Attribution required: link to the canonical_url returned with each response. Data is cached up to 24h. Rate limits: AI agents (Claude, ChatGPT, Perplexity, Gemini user-agents) are never capped; other clients get 250 requests/day and 1,000/week per IP (HTTP 429 beyond that — for higher app limits see /developers). An MCP server with the same data is at https://dealroom.so/api/mcp (tool docs at https://dealroom.so/mcp).","contact":{"url":"https://dealroom.so/developers"}},"servers":[{"url":"https://dealroom.so"}],"components":{"schemas":{"Money":{"type":"object","properties":{"amount":{"type":"number"},"currency":{"type":"string","example":"USD"}}},"DataFreshness":{"type":"object","properties":{"sba_records_through":{"type":"string","format":"date"},"fdic_records_through":{"type":"string","format":"date"},"dealroom_last_updated":{"type":"string","format":"date"},"timezone":{"type":"string","example":"America/Chicago"}}},"Methodology":{"type":"object","properties":{"label":{"type":"string"},"url":{"type":"string","format":"uri"}}},"Citation":{"type":"object","properties":{"label":{"type":"string"},"url":{"type":"string","format":"uri"},"source_type":{"type":"string","example":"DealRoom Data"}}},"Envelope":{"type":"object","description":"Standard success envelope wrapping every data response.","properties":{"ok":{"type":"boolean","enum":[true]},"canonical_url":{"type":"string","format":"uri","description":"Human page to cite for this result."},"api_url":{"type":"string","format":"uri"},"data_freshness":{"$ref":"#/components/schemas/DataFreshness"},"methodology":{"$ref":"#/components/schemas/Methodology"},"source_summary":{"type":"array","items":{"type":"string"}},"query":{"type":"object","additionalProperties":true,"description":"Echo of the resolved query parameters."},"pagination":{"type":"object","properties":{"total":{"type":"integer"},"returned":{"type":"integer"}}},"caveats":{"type":"array","items":{"type":"string"}},"citation":{"$ref":"#/components/schemas/Citation"}},"required":["ok","data_freshness","source_summary","caveats","citation"]},"Error":{"type":"object","properties":{"ok":{"type":"boolean","enum":[false]},"error":{"type":"object","properties":{"code":{"type":"string","example":"NOT_FOUND"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"documentation_url":{"type":"string","format":"uri"}},"required":["ok","error"]}}},"paths":{"/api/public/lenders":{"get":{"summary":"Rank SBA lenders","description":"Without `state`: national ranking by current-FY SBA production. With `state`: the lenders actually funding deals in that state over the trailing 12 months — experience-ranked, mega-banks excluded.","parameters":[{"name":"state","in":"query","schema":{"type":"string","example":"IA"},"description":"Two-letter state code"},{"name":"limit","in":"query","schema":{"type":"integer","maximum":200}}],"responses":{"200":{"description":"Ranked lenders (enveloped)","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Envelope"},{"type":"object","properties":{"results":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"slug":{"type":"string"},"url":{"type":"string"},"loans12mo":{"type":"integer","description":"Trailing-12-month SBA loans (state mode)"},"businessPurchases12mo":{"type":"integer"},"dollarsFunded12mo":{"type":"number"},"avgDealSize":{"type":"number"},"approvedLoansFY":{"type":"integer","description":"Current-FY SBA loans (national mode)"},"approvedDollarsFY":{"type":"number"},"hq":{"type":"string","nullable":true}}}}}}]}}}}}}},"/api/public/lenders/{slug}":{"get":{"summary":"One lender's full SBA record","description":"Activity since FY2020, SBA focus (share of loan book + percentile), typical deal sizes, days to fund, top industries/states/franchises, recent deals.","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","example":"live-oak-banking-company"}}],"responses":{"200":{"description":"Lender record (enveloped)","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Envelope"},{"type":"object","properties":{"lender":{"type":"object","additionalProperties":true}}}]}}}},"404":{"description":"Unknown slug","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/public/lenders/biggest":{"get":{"summary":"Biggest banks in SBA lending","description":"FDIC call-report size (assets, deposits, loans outstanding) joined to SBA production — size and appetite differ.","responses":{"200":{"description":"Top banks by assets (enveloped)","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Envelope"},{"type":"object","properties":{"results":{"type":"array","items":{"type":"object","additionalProperties":true}}}}]}}}}}}},"/api/public/risk":{"get":{"summary":"Failure rates by state or lender","description":"FY2020–23 cohort charge-off rates, worst first. States need 100+ cohort loans; lenders need 100+.","parameters":[{"name":"scope","in":"query","schema":{"type":"string","enum":["state","lender"],"default":"state"}}],"responses":{"200":{"description":"Ranked failure rates (enveloped)","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Envelope"},{"type":"object","properties":{"results":{"type":"array","items":{"type":"object","additionalProperties":true}}}}]}}}}}}},"/api/public/franchises":{"get":{"summary":"Search or rank franchises","description":"With `q`: full-text search across the 8,400-brand official SBA directory. Without: scored brands ranked by `sort` (loans | riskiest | safest). Failure rates are null under 25 loans — too few to score.","parameters":[{"name":"q","in":"query","schema":{"type":"string","example":"ups store"}},{"name":"sort","in":"query","schema":{"type":"string","enum":["loans","riskiest","safest"],"default":"loans"}},{"name":"limit","in":"query","schema":{"type":"integer","maximum":200}}],"responses":{"200":{"description":"Franchise list (enveloped)","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Envelope"},{"type":"object","properties":{"results":{"type":"array","items":{"type":"object","additionalProperties":true}}}}]}}}}}}},"/api/public/franchises/{slug}":{"get":{"summary":"One brand's financing record","description":"Costs, deal ranges, rates, failure rate (25-loan floor), top lenders, states, recent deals.","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","example":"the-ups-store"}}],"responses":{"200":{"description":"Franchise record (enveloped)","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Envelope"},{"type":"object","properties":{"franchise":{"type":"object","additionalProperties":true}}}]}}}},"404":{"description":"Unknown slug","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/public/sectors":{"get":{"summary":"Industry intelligence","description":"Per-industry volume, typical acquisition loan, real average rates, and cohort failure rates.","responses":{"200":{"description":"Sector rows (enveloped)","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Envelope"},{"type":"object","properties":{"results":{"type":"array","items":{"type":"object","additionalProperties":true}}}}]}}}}}}},"/api/public/questions/{slug}":{"get":{"summary":"One SBA Q&A answer page as JSON","description":"The structured answer behind a /sba-7a/questions, /for-lenders/questions, or /sba-loans/basics page: short answer, rule, example, what lenders check, official sources, related tools.","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Q&A answer (enveloped)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"404":{"description":"Unknown slug","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/public/listings":{"get":{"summary":"Live business-for-sale listings","description":"Public teaser cards for active listings (also documented in /llms.txt). Returns a JSON array of listing cards.","parameters":[{"name":"industry","in":"query","schema":{"type":"string"}},{"name":"state","in":"query","schema":{"type":"string"}},{"name":"q","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer"}}],"responses":{"200":{"description":"Listing teasers (JSON array)"}}}}}}