{"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/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/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":false,"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":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"}}},"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":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"}}},"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":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"}}},"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/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":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"}}}}}}