{"openapi":"3.1.0","info":{"title":"GovBiz public data API","version":"2026-10-11","description":"Documented read-only catalogue routes. Requires active API access. REST and MCP share request limits. Samples omit public contact details."},"servers":[{"url":"https://www.govbiz.ai","description":"Production"}],"security":[{"ApiKey":[]}],"paths":{"/api/v2/opportunities/search":{"get":{"tags":["v2-opportunities"],"summary":"[V2] Search SAM.gov opportunities with full filter surface","operationId":"search_opportunities_api_v2_opportunities_search_get","parameters":[{"name":"naics_codes","in":"query","required":false,"schema":{"type":"array","items":{"type":"string"},"default":[],"title":"Naics Codes"}},{"name":"naics_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Naics Code"}},{"name":"query","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Alias for keyword","title":"Query"},"description":"Alias for keyword"},{"name":"notice_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notice Type"}},{"name":"state","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State"}},{"name":"set_aside","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Set Aside"}},{"name":"agency_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agency Code"}},{"name":"set_aside_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Set Aside Type"}},{"name":"notice_types","in":"query","required":false,"schema":{"type":"array","items":{"type":"string"},"default":[],"title":"Notice Types"}},{"name":"pop_state","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Place of performance state (2-letter)","title":"Pop State"},"description":"Place of performance state (2-letter)"},{"name":"pop_city","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Place of performance city","title":"Pop City"},"description":"Place of performance city"},{"name":"contracting_office_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"AAC/contracting office code e.g. FA5000","title":"Contracting Office Code"},"description":"AAC/contracting office code e.g. FA5000"},{"name":"installation","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Base/installation name keyword search","title":"Installation"},"description":"Base/installation name keyword search"},{"name":"keyword","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Keyword"}},{"name":"value_min","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Value Min"}},{"name":"value_max","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Value Max"}},{"name":"deadline_within_days","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":365,"minimum":1},{"type":"null"}],"title":"Deadline Within Days"}},{"name":"posted_within_days","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":365,"minimum":1},{"type":"null"}],"description":"Only opportunities posted within the last N days (e.g. 7 = this week)","title":"Posted Within Days"},"description":"Only opportunities posted within the last N days (e.g. 7 = this week)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"title":"Response Search Opportunities Api V2 Opportunities Search Get"}}}},"401":{"description":"Missing or invalid credentials"},"402":{"description":"API access is not active"},"403":{"description":"Access, key scope, or domain permission denied"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Shared request allowance or concurrency limit reached"},"503":{"description":"Source or execution service unavailable"}},"security":[{"ApiKey":[]}]}},"/api/v2/contracts/search":{"get":{"tags":["Contract Intelligence"],"summary":"Search Contracts","description":"Keyword/structured search over FPDS award descriptions.\n\n`q` is optional: with a query it ranks by full-text relevance; without\none (e.g. \"all FPDS awards under NAICS 621330\") it returns the most\nrecent awards matching the structured filters. Previously q was\nrequired AND the NAICS/agency filters were the only structural ones -\ncallers that omitted q got a 422, and the structured-only use case\n(the common \"what awards exist in my NAICS\" question) was impossible.\n\nReturns raw award rows with no dollar figures - `fpds_award_descriptions`\ndoesn't carry obligation amounts. Without a date_from/date_to filter,\n\"most recent\" ordering plus `limit` means the default view can be\nentirely one day's batch of awards, which skews toward whatever NAICS\nhad a high-volume day rather than the agency's actual spending mix. Use\nGET /contracts/search/summary for a dollar-weighted, date-range-aware\nbreakdown instead of eyeballing raw rows.","operationId":"search_contracts_api_v2_contracts_search_get","parameters":[{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Full-text search query (optional)","title":"Q"},"description":"Full-text search query (optional)"},{"name":"query","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Alias for q","title":"Query"},"description":"Alias for q"},{"name":"naics_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Naics Code"}},{"name":"agency_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agency Code"}},{"name":"set_aside","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Set Aside"}},{"name":"set_aside_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Alias for set_aside (MCP tool param name)","title":"Set Aside Type"},"description":"Alias for set_aside (MCP tool param name)"},{"name":"date_from","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Only include awards on/after this action date (YYYY-MM-DD)","title":"Date From"},"description":"Only include awards on/after this action date (YYYY-MM-DD)"},{"name":"date_to","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Only include awards on/before this action date (YYYY-MM-DD)","title":"Date To"},"description":"Only include awards on/before this action date (YYYY-MM-DD)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":25,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"description":"Missing or invalid credentials"},"402":{"description":"API access is not active"},"403":{"description":"Access, key scope, or domain permission denied"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Shared request allowance or concurrency limit reached"},"503":{"description":"Source or execution service unavailable"}},"security":[{"ApiKey":[]}]}},"/api/v2/grants/search":{"get":{"tags":["v2-grants"],"summary":"[V2] Search federal grant opportunities (Grants.gov)","description":"[V2] Live keyword/filter search over Grants.gov federal grant opportunities.\n\nRequirement: V2-API-GRANTS-001","operationId":"search_grants_api_v2_grants_search_get","parameters":[{"name":"query","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Keyword matched against grant title/description","title":"Query"},"description":"Keyword matched against grant title/description"},{"name":"agency_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Awarding agency code, e.g. HHS, USDA, ED","title":"Agency Code"},"description":"Awarding agency code, e.g. HHS, USDA, ED"},{"name":"eligibility","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Grants.gov eligibility code. Nonprofit-relevant codes: 12 = nonprofits with 501(c)(3) status; 13 = nonprofits without 501(c)(3); 25 = other; 99 = unrestricted/open to any entity.","title":"Eligibility"},"description":"Grants.gov eligibility code. Nonprofit-relevant codes: 12 = nonprofits with 501(c)(3) status; 13 = nonprofits without 501(c)(3); 25 = other; 99 = unrestricted/open to any entity."},{"name":"funding_category","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Grants.gov funding category code, e.g. ED (education), HL (health)","title":"Funding Category"},"description":"Grants.gov funding category code, e.g. ED (education), HL (health)"},{"name":"cfda","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Assistance Listing Number / CFDA (e.g. 93.600)","title":"Cfda"},"description":"Assistance Listing Number / CFDA (e.g. 93.600)"},{"name":"status","in":"query","required":false,"schema":{"type":"string","description":"Pipe-separated opportunity statuses: forecasted|posted|closed|archived. Default 'posted|forecasted'.","default":"posted|forecasted","title":"Status"},"description":"Pipe-separated opportunity statuses: forecasted|posted|closed|archived. Default 'posted|forecasted'."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"title":"Response Search Grants Api V2 Grants Search Get"}}}},"401":{"description":"Missing or invalid credentials"},"402":{"description":"API access is not active"},"403":{"description":"Access, key scope, or domain permission denied"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Shared request allowance or concurrency limit reached"},"503":{"description":"Source or execution service unavailable"}},"security":[{"ApiKey":[]}]}},"/api/v2/intelligence/acquisition-forecasts":{"get":{"tags":["v2-forecasts"],"summary":"Search published agency acquisition forecasts","description":"Search current published acquisition forecasts without profile context.","operationId":"get_procurement_forecasts_api_v2_intelligence_acquisition_forecasts_get","parameters":[{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Title and description search","title":"Q"},"description":"Title and description search"},{"name":"source_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Id"}},{"name":"record_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Record Type"}},{"name":"agency_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Agency code filter","title":"Agency Code"},"description":"Agency code filter"},{"name":"subagency_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subagency Code"}},{"name":"contracting_office_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Contracting Office Code"}},{"name":"naics_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"NAICS code filter","title":"Naics Code"},"description":"NAICS code filter"},{"name":"psc_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Psc Code"}},{"name":"fiscal_year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Fiscal year filter","title":"Fiscal Year"},"description":"Fiscal year filter"},{"name":"forecast_status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Forecast Status"}},{"name":"set_aside_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Set Aside Type"}},{"name":"contract_vehicle","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Contract Vehicle"}},{"name":"solicitation_date_from","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Solicitation Date From"}},{"name":"solicitation_date_to","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Solicitation Date To"}},{"name":"award_date_from","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Award Date From"}},{"name":"award_date_to","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Award Date To"}},{"name":"value_min","in":"query","required":false,"schema":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}],"title":"Value Min"}},{"name":"value_max","in":"query","required":false,"schema":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}],"title":"Value Max"}},{"name":"include_inactive","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Include Inactive"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Opaque pagination cursor","title":"Cursor"},"description":"Opaque pagination cursor"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"title":"Response Get Procurement Forecasts Api V2 Intelligence Acquisition Forecasts Get"}}}},"401":{"description":"Missing or invalid credentials"},"402":{"description":"API access is not active"},"403":{"description":"Access, key scope, or domain permission denied"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Shared request allowance or concurrency limit reached"},"503":{"description":"Source or execution service unavailable"}},"security":[{"ApiKey":[]}]}},"/api/v2/intelligence/agency-web/documents":{"get":{"tags":["v2-agency-web"],"summary":"Search current Agency Website Intelligence documents","operationId":"list_documents_api_v2_intelligence_agency_web_documents_get","parameters":[{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Title and extracted-content query","title":"Q"},"description":"Title and extracted-content query"},{"name":"organization_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organization Id"}},{"name":"source_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Id"}},{"name":"domain","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain"}},{"name":"path_prefix","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Path Prefix"}},{"name":"document_kind","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Document Kind"}},{"name":"active_only","in":"query","required":false,"schema":{"type":"boolean","default":true,"title":"Active Only"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"title":"Response List Documents Api V2 Intelligence Agency Web Documents Get"}}}},"401":{"description":"Missing or invalid credentials"},"402":{"description":"API access is not active"},"403":{"description":"Access, key scope, or domain permission denied"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Shared request allowance or concurrency limit reached"},"503":{"description":"Source or execution service unavailable"}},"security":[{"ApiKey":[]}]}}},"components":{"securitySchemes":{"ApiKey":{"type":"http","scheme":"bearer","description":"API key from your workspace. Store it securely."}},"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}