{"openapi":"3.1.0","info":{"title":"Fed-Spend API v2","version":"2.0.0","description":"Federal-spending intelligence: search, recompete radar, NAICS competition, pricing benchmarks, GAO protests, contractor performance, and the pWin Verdict engine. Authenticate with a Bearer API key from /api-dashboard. The same capabilities are available to AI agents over MCP at /api/mcp."},"servers":[{"url":"https://fed-spend.com"}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"fsp_live_..."}},"schemas":{"SuccessEnvelope":{"type":"object","properties":{"data":{},"meta":{"type":"object"}},"required":["data"]},"ErrorEnvelope":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}},"required":["error"]}},"responses":{"Error":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}},"security":[{"bearerAuth":[]}],"paths":{"/api/v2/search":{"post":{"operationId":"search","summary":"Search federal spending data (contracts, awards, recipients, agencies, sub-awards, SAM.gov opportunities, entity verification). Results capped by tier.","tags":["Read"],"security":[{"bearerAuth":[]}],"x-min-tier":"free","x-available-via-mcp":true,"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"402":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"searchMode":{"type":"string","enum":["contracts","awards","agencies","subAwards","recipients","recompete","setAside","contractGrowth","samOpportunities","entityVerify"],"description":"Type of federal data to query"},"keyword":{"description":"Free-text keyword","type":"string","maxLength":200},"agency":{"description":"Agency code or name, e.g. DOD, VA","type":"string","maxLength":100},"naicsCode":{"description":"2-6 digit NAICS code","type":"string","pattern":"^\\d{2,6}$"},"setAsideType":{"description":"e.g. 8(a), SDVOSB, HUBZone, WOSB","type":"string","maxLength":50},"noticeType":{"description":"Pre-solicitation notice filter for samOpportunities mode","type":"string","enum":["sources_sought","rfi","presolicitation","special_notice","combined_synopsis"]},"dateFrom":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"dateTo":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"minAmount":{"type":"number","minimum":0},"maxAmount":{"type":"number","minimum":0},"maxResults":{"type":"integer","minimum":1,"maximum":1000}}}}}}}},"/api/v2/recompete":{"get":{"operationId":"recompete","summary":"Find expiring federal contracts (recompete opportunities) with urgency and a recompete score. Researcher tier and up.","tags":["Read"],"security":[{"bearerAuth":[]}],"x-min-tier":"researcher","x-available-via-mcp":true,"parameters":[{"name":"urgency","in":"query","required":false,"schema":{"type":"string","enum":["HIGH","MEDIUM","STANDARD"]}},{"name":"agency","in":"query","required":false,"schema":{"type":"string","maxLength":100}},{"name":"minValue","in":"query","required":false,"schema":{"type":"number","minimum":0}},{"name":"maxDays","in":"query","required":false,"schema":{"description":"Max days until expiration","type":"integer","minimum":1,"maximum":720}},{"name":"sortBy","in":"query","required":false,"schema":{"type":"string","enum":["daysRemaining","value","recompeteScore"]}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":200}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"402":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/api/v2/pre-rfp-forecast":{"get":{"operationId":"pre_rfp_forecast","summary":"Pre-RFP Forecast Fusion: predicts solicitation windows (Sources Sought through RFP) by fusing expiring awards, agency+NAICS demand trajectory, incumbent vulnerability, and SAM.gov leading indicators. Free tier gets a quantified teaser; Professional tier gets full timelines and reasoning.","tags":["Read"],"security":[{"bearerAuth":[]}],"x-min-tier":"free","x-available-via-mcp":true,"parameters":[{"name":"agency","in":"query","required":false,"schema":{"type":"string","maxLength":100}},{"name":"naicsCode","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d{2,6}$"}},{"name":"setAside","in":"query","required":false,"schema":{"type":"string","maxLength":50}},{"name":"minValue","in":"query","required":false,"schema":{"type":"number","minimum":0}},{"name":"window","in":"query","required":false,"schema":{"description":"Max days until POP end (default 540)","type":"integer","minimum":90,"maximum":720}},{"name":"sortBy","in":"query","required":false,"schema":{"type":"string","enum":["forecastConfidence","window","value","demandTrend"]}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100}},{"name":"noticeType","in":"query","required":false,"schema":{"description":"Pre-solicitation notice type filter (Phase 2)","type":"string","maxLength":80}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"402":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/api/v2/buyer-intel/{code}":{"get":{"operationId":"buyer_intel","summary":"Agency Buyer Intelligence: how a federal buying organization awards - spend trajectory, incumbent concentration, set-aside posture, protest friction, and recompete pipeline, fused into one scored verdict. Free tier gets the headline stat and score; Professional unlocks full vendor/NAICS/set-aside tables and the capture brief.","tags":["Read"],"security":[{"bearerAuth":[]}],"x-min-tier":"free","x-available-via-mcp":true,"parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string","minLength":2,"maxLength":40,"description":"Agency code or slug, e.g. DOD or department-of-defense"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"402":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/api/v2/subaward-hub":{"get":{"operationId":"subaward_hub","summary":"Subaward Hub (FSRS): subcontracting flows by agency or NAICS - which primes pass the most work to subs and who the active subcontractors are. Free tier gets the leaderboard headline and top 3; Professional unlocks full prime/sub/NAICS tables.","tags":["Read"],"security":[{"bearerAuth":[]}],"x-min-tier":"free","x-available-via-mcp":true,"parameters":[{"name":"agency","in":"query","required":false,"schema":{"type":"string","maxLength":100}},{"name":"naicsCode","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d{2,6}$"}},{"name":"minValue","in":"query","required":false,"schema":{"type":"number","minimum":0}},{"name":"sortBy","in":"query","required":false,"schema":{"type":"string","enum":["subValue","subCount","intensity"]}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"402":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/api/v2/subaward-profile/{slug}":{"get":{"operationId":"subaward_profile","summary":"Prime subcontracting profile (FSRS): how much a prime subcontracts, top sub-recipients, NAICS pass-through, and a teaming-opportunity verdict. Free tier gets the score and headline; Professional unlocks the full teaming brief and tables.","tags":["Read"],"security":[{"bearerAuth":[]}],"x-min-tier":"free","x-available-via-mcp":true,"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","minLength":2,"maxLength":80,"description":"Prime contractor slug, e.g. lockheed-martin"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"402":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/api/v2/naics":{"get":{"operationId":"naics_competition","summary":"Competition density for a NAICS code: unique firms, dollars per firm, set-aside breakdown, top agencies and firms. Researcher tier and up.","tags":["Read"],"security":[{"bearerAuth":[]}],"x-min-tier":"researcher","x-available-via-mcp":true,"parameters":[{"name":"naicsCode","in":"query","required":true,"schema":{"type":"string","pattern":"^\\d{2,6}$","description":"2-6 digit NAICS code (required)"}},{"name":"setAside","in":"query","required":false,"schema":{"description":"Filter by set-aside type","type":"string","maxLength":50}},{"name":"fiscalYear","in":"query","required":false,"schema":{"type":"integer","minimum":2015,"maximum":2030}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"402":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/api/v2/pricing":{"get":{"operationId":"pricing","summary":"Pricing benchmarks for a NAICS code: percentiles, agency premiums, competition-type and set-aside deltas, plain-language insights. Professional tier and up.","tags":["Read"],"security":[{"bearerAuth":[]}],"x-min-tier":"professional","x-available-via-mcp":true,"parameters":[{"name":"naicsCode","in":"query","required":true,"schema":{"type":"string","pattern":"^\\d{2,6}$","description":"2-6 digit NAICS code (required)"}},{"name":"agency","in":"query","required":false,"schema":{"type":"string","maxLength":100}},{"name":"fiscalYear","in":"query","required":false,"schema":{"type":"integer","minimum":2015,"maximum":2030}},{"name":"competitionType","in":"query","required":false,"schema":{"type":"string","enum":["all","competitive","solesource"]}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"402":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/api/v2/price-to-win":{"get":{"operationId":"price_to_win","summary":"Opportunity-specific recommended bid range from comparable winning awards: low/target/high band, percentile fit, and where winning bids clustered. Free + Researcher get sample size and median; Professional and up get the full band.","tags":["Read"],"security":[{"bearerAuth":[]}],"x-min-tier":"professional","x-available-via-mcp":true,"parameters":[{"name":"naicsCode","in":"query","required":false,"schema":{"description":"2-6 digit NAICS code","type":"string","pattern":"^\\d{2,6}$"}},{"name":"pscCode","in":"query","required":false,"schema":{"description":"Product/Service Code","type":"string","pattern":"^[A-Za-z0-9]{1,5}$"}},{"name":"agency","in":"query","required":false,"schema":{"type":"string","maxLength":120}},{"name":"setAside","in":"query","required":false,"schema":{"type":"string","maxLength":60}},{"name":"targetValue","in":"query","required":false,"schema":{"description":"Your opportunity value, for percentile fit","type":"number","minimum":0,"maximum":1000000000000}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"402":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/api/v2/rfp/analyze":{"post":{"operationId":"rfp_shred","summary":"Shred a federal RFP into a compliance matrix: Section L/M, shall-statements, submission rules, and key dates. Accepts a SAM.gov noticeId (from search results - the one-click path), a SAM.gov URL, or pasted solicitation text. Returns an analysisId to poll with rfp_get. Free + Researcher get the teaser; Professional and up get the full matrix.","tags":["Write"],"security":[{"bearerAuth":[]}],"x-min-tier":"free","x-available-via-mcp":true,"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"402":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"noticeId":{"description":"SAM.gov notice id from a search result - fetches the notice description and attachments automatically","type":"string","pattern":"^[a-zA-Z0-9-]{8,64}$"},"solicitationUrl":{"description":"SAM.gov opportunity URL","type":"string","maxLength":2000,"format":"uri"},"rawText":{"description":"Pasted or extracted solicitation text (alternative to URL)","type":"string","minLength":500,"maxLength":200000},"sourceType":{"description":"For rawText input: upload or text","type":"string","enum":["upload","text"]},"sourceLabel":{"description":"Filename or notice title for rawText input","type":"string","maxLength":300},"title":{"description":"Optional notice title (used with noticeId)","type":"string","maxLength":500}}}}}}}},"/api/v2/rfp/{id}":{"get":{"operationId":"rfp_get","summary":"Retrieve a shredded RFP by analysisId: status, extracted metadata, and (Professional+) the full compliance matrix, Section L/M, and go/no-go. Free + Researcher receive the teaser payload.","tags":["Read"],"security":[{"bearerAuth":[]}],"x-min-tier":"free","x-available-via-mcp":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"RFP analysis id returned by rfp_shred"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"402":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/api/v2/rfp/{id}/draft":{"post":{"operationId":"rfp_draft","summary":"Turn a completed shred into a proposal shell: Section L/M-mapped outline, win themes, shall-statement crosswalk, and a solicitation-tailored capability statement. Drafted by a Kimi model with GPT-4o and deterministic fallbacks. Poll rfp_draft_get for the result.","tags":["Write"],"security":[{"bearerAuth":[]}],"x-min-tier":"professional","x-available-via-mcp":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"RFP analysis id (a completed shred) from rfp_shred"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"402":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"regenerate":{"description":"Force a fresh draft, replacing any existing one","type":"boolean"}}}}}}},"get":{"operationId":"rfp_draft_get","summary":"Retrieve the current proposal draft for a shred: status (processing/completed/failed) plus the structured shell (outline, win themes, crosswalk, capability narrative).","tags":["Read"],"security":[{"bearerAuth":[]}],"x-min-tier":"professional","x-available-via-mcp":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"RFP analysis id from rfp_shred"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"402":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/api/v2/protests":{"get":{"operationId":"protests","summary":"Search GAO bid protests by agency, protester, contract, solicitation, or outcome.","tags":["Read"],"security":[{"bearerAuth":[]}],"x-min-tier":"researcher","x-available-via-mcp":true,"parameters":[{"name":"agency","in":"query","required":false,"schema":{"type":"string","maxLength":120}},{"name":"contractor","in":"query","required":false,"schema":{"description":"Protester name","type":"string","maxLength":200}},{"name":"contractNumber","in":"query","required":false,"schema":{"type":"string","maxLength":100}},{"name":"solicitationNumber","in":"query","required":false,"schema":{"type":"string","maxLength":100}},{"name":"outcome","in":"query","required":false,"schema":{"type":"string","enum":["sustained","denied","dismissed","withdrawn"]}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"maximum":9007199254740991}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"402":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/api/v2/protests/stats":{"post":{"operationId":"protest_stats","summary":"Aggregate GAO protest statistics (sustain rate, outcome counts, recency) for an agency or contractor.","tags":["Read"],"security":[{"bearerAuth":[]}],"x-min-tier":"researcher","x-available-via-mcp":true,"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"402":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"agency":{"type":"string","maxLength":120},"contractor":{"type":"string","maxLength":200}}}}}}}},"/api/v2/performance/{uei}":{"get":{"operationId":"performance","summary":"Past-performance profile for a contractor by SAM.gov UEI (CPARS-style ratings plus registration). Degrades gracefully when performance data is sparse.","tags":["Read"],"security":[{"bearerAuth":[]}],"x-min-tier":"researcher","x-available-via-mcp":true,"parameters":[{"name":"uei","in":"path","required":true,"schema":{"type":"string","minLength":3,"maxLength":20,"description":"SAM.gov Unique Entity ID (required)"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"402":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/api/v2/set-aside":{"get":{"operationId":"set_aside","summary":"Scan set-aside contracts (8(a), SDVOSB, HUBZone, WOSB and more). Professional tier and up.","tags":["Read"],"security":[{"bearerAuth":[]}],"x-min-tier":"professional","x-available-via-mcp":true,"parameters":[{"name":"setAsideType","in":"query","required":false,"schema":{"type":"string","maxLength":50}},{"name":"naicsCode","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d{2,6}$"}},{"name":"agency","in":"query","required":false,"schema":{"type":"string","maxLength":100}},{"name":"maxResults","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":500}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"402":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/api/v2/growth":{"get":{"operationId":"contract_growth","summary":"Find contracts with significant obligated-value growth (forensic signal). Enterprise tier.","tags":["Read"],"security":[{"bearerAuth":[]}],"x-min-tier":"enterprise","x-available-via-mcp":true,"parameters":[{"name":"naicsCode","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d{2,6}$"}},{"name":"agency","in":"query","required":false,"schema":{"type":"string","maxLength":100}},{"name":"minGrowthPct","in":"query","required":false,"schema":{"type":"number","minimum":0}},{"name":"maxResults","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":500}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"402":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/api/v2/pwin":{"post":{"operationId":"pwin_verdict","summary":"Win Probability (pWin) Verdict: fuses incumbent vulnerability, NAICS competition, profile fit, price-to-win, past performance, and set-aside leverage into one 0-100 score with cited components. Free tier gets a teaser; paid tiers get the full breakdown.","tags":["Read"],"security":[{"bearerAuth":[]}],"x-min-tier":"free","x-available-via-mcp":true,"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"402":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"contractId":{"type":"string","maxLength":200},"incumbentUei":{"type":"string","maxLength":20},"incumbentName":{"type":"string","maxLength":200},"naicsCode":{"type":"string","pattern":"^\\d{2,6}$"},"agency":{"type":"string","maxLength":120},"setAsideType":{"type":"string","maxLength":60},"contractValue":{"type":"number","minimum":0}}}}}}}},"/api/v2/pwin/history":{"get":{"operationId":"pwin_history","summary":"List your recent pWin verdicts.","tags":["Read"],"security":[{"bearerAuth":[]}],"x-min-tier":"researcher","x-available-via-mcp":true,"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"402":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/api/v2/pwin/outcome":{"post":{"operationId":"pwin_outcome","summary":"Record the real win/loss outcome of an opportunity so the pWin model calibrates to your history.","tags":["Write"],"security":[{"bearerAuth":[]}],"x-min-tier":"researcher","x-available-via-mcp":true,"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"402":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"opportunityKey":{"type":"string","minLength":1,"maxLength":200,"description":"The opportunity key from a prior verdict"},"outcome":{"type":"string","enum":["won","lost","no_bid","pending"],"description":"Actual outcome"},"awardedValue":{"type":"number","minimum":0},"notes":{"type":"string","maxLength":1000}},"required":["opportunityKey","outcome"]}}}}}},"/api/v2/pipeline":{"get":{"operationId":"pipeline_list","summary":"List opportunities in your BD pipeline, with per-stage summary.","tags":["Read"],"security":[{"bearerAuth":[]}],"x-min-tier":"free","x-available-via-mcp":true,"parameters":[{"name":"stage","in":"query","required":false,"schema":{"type":"string","enum":["identified","researching","pursuing","proposal","submitted","won","lost"]}},{"name":"priority","in":"query","required":false,"schema":{"type":"string","enum":["high","medium","low"]}},{"name":"sortBy","in":"query","required":false,"schema":{"type":"string","enum":["created_at","updated_at","deadline","value","stage","priority"]}},{"name":"sortOrder","in":"query","required":false,"schema":{"type":"string","enum":["asc","desc"]}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"402":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}},"post":{"operationId":"pipeline_add","summary":"Add or update an opportunity in your BD pipeline. Subject to per-tier pipeline limits.","tags":["Write"],"security":[{"bearerAuth":[]}],"x-min-tier":"free","x-available-via-mcp":true,"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"402":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"opportunityId":{"type":"string","minLength":1,"description":"Stable id for the opportunity (required)"},"title":{"type":"string","maxLength":500},"agency":{"type":"string","maxLength":255},"value":{"type":"number"},"stage":{"type":"string","enum":["identified","researching","pursuing","proposal","submitted","won","lost"]},"priority":{"type":"string","enum":["high","medium","low"]},"deadline":{"description":"ISO date","type":"string"},"naicsCode":{"type":"string","maxLength":10},"setAsideType":{"type":"string","maxLength":100},"incumbent":{"type":"string","maxLength":500},"notes":{"type":"string","maxLength":4000}},"required":["opportunityId"]}}}}}},"/api/v2/alerts":{"get":{"operationId":"alerts_list","summary":"List your saved contract alerts.","tags":["Read"],"security":[{"bearerAuth":[]}],"x-min-tier":"researcher","x-available-via-mcp":true,"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"402":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}},"post":{"operationId":"alerts_create","summary":"Create a real-time contract alert. Researcher tier and up.","tags":["Write"],"security":[{"bearerAuth":[]}],"x-min-tier":"researcher","x-available-via-mcp":true,"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"402":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":100},"keyword":{"type":"string","maxLength":200},"agency":{"type":"string","maxLength":100},"setAsideType":{"type":"string","maxLength":50},"minAmount":{"type":"number","minimum":0},"maxAmount":{"type":"number","minimum":0},"frequency":{"type":"string","enum":["hourly","realtime","daily","weekly"]},"notifyEmail":{"type":"boolean"},"notifySlack":{"type":"boolean"}},"required":["name"]}}}}}},"/api/v2/saved-searches":{"get":{"operationId":"saved_searches_list","summary":"List your saved searches.","tags":["Read"],"security":[{"bearerAuth":[]}],"x-min-tier":"free","x-available-via-mcp":true,"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"402":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}},"post":{"operationId":"saved_searches_create","summary":"Save a search definition for reuse. Subject to per-tier limits.","tags":["Write"],"security":[{"bearerAuth":[]}],"x-min-tier":"free","x-available-via-mcp":true,"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"402":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":100},"searchParams":{"description":"Arbitrary search parameters to store","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["name"]}}}}}},"/api/v2/competitors":{"get":{"operationId":"competitors_list","summary":"List the competitors you are tracking.","tags":["Read"],"security":[{"bearerAuth":[]}],"x-min-tier":"researcher","x-available-via-mcp":true,"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"402":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}},"post":{"operationId":"competitors_track","summary":"Track a competitor by name or UEI to monitor their award activity.","tags":["Write"],"security":[{"bearerAuth":[]}],"x-min-tier":"researcher","x-available-via-mcp":true,"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"402":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"competitorName":{"type":"string","minLength":1,"maxLength":255},"competitorUei":{"type":"string","maxLength":20},"naicsCode":{"type":"string","maxLength":10}},"required":["competitorName"]}}}}}},"/api/v2/company-card":{"get":{"operationId":"company_card","summary":"One-shot company intelligence brief for a federal contractor by name: total obligations, award count, top buying agencies, NAICS mix, contracts expiring within 12 months, GAO protest record, and cached performance. Returns null when the name does not confidently resolve to one company.","tags":["Read"],"security":[{"bearerAuth":[]}],"x-min-tier":"free","x-available-via-mcp":true,"parameters":[{"name":"name","in":"query","required":true,"schema":{"type":"string","minLength":3,"maxLength":80,"description":"Company name, e.g. \"Palantir\" or \"Booz Allen\""}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"402":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/api/v2/dashboard/stats":{"get":{"operationId":"dashboard_stats","summary":"Your dashboard KPIs and usage summary.","tags":["Read"],"security":[{"bearerAuth":[]}],"x-min-tier":"free","x-available-via-mcp":false,"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"402":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/api/v2/analytics":{"get":{"operationId":"analytics","summary":"Your usage and activity analytics.","tags":["Read"],"security":[{"bearerAuth":[]}],"x-min-tier":"researcher","x-available-via-mcp":false,"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"402":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/api/v2/profile":{"get":{"operationId":"profile_get","summary":"Get your saved company profile (NAICS, certifications, preferences).","tags":["Read"],"security":[{"bearerAuth":[]}],"x-min-tier":"free","x-available-via-mcp":true,"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"402":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}}}}