# Opportunities The opportunities endpoints search SAM.gov contract notices by keyword, NAICS, PSC, set-aside, agency, state, type and posted or deadline dates, and return each notice with its full description and the contacts printed in it. One notice by ID (/api/v1/opportunities/{notice_id}) returns the full description. Contracting-officer contacts are returned as printed in the public notice on plans with the intelligence features.Checked on 2026-11-12.Official source: [open.gsa.gov Get Opportunities API](https://open.gsa.gov/api/get-opportunities-public-api/) | Search | /opportunities?q=%7Bkeywords%7D&active=true | | --- | --- | | Get | /opportunities/{notice_id} | | Refresh | Nightly from the SAM.gov file | ## Example ``` curl "https://samgovapi.io/api/v1/opportunities?q=cybersecurity&active=true" \ -H "Authorization: Bearer sg_YOUR_KEY" ``` ## Search parameters | Parameter | Meaning | | --- | --- | | q | Words in the title or the solicitation number | | naics | NAICS code or prefix | | psc | PSC code | | set_aside | Set-aside code, such as SBA, 8A, WOSB or SDVOSBC | | agency | Department or sub-tier name | | state | Place of performance state | | type | Notice type, such as Solicitation | | posted_from, posted_to | Posted date range, YYYY-MM-DD | | deadline_from | Response deadline on or after, YYYY-MM-DD | | active | true for open notices only | ## Contacts in notices One notice by ID (/api/v1/opportunities/{notice_id}) returns the full description. Contracting-officer contacts are returned as printed in the public notice on plans with the intelligence features. ## Get this as JSON ``` curl "https://samgovapi.io/api/v1/opportunities?q=cybersecurity&active=true" \ -H "Authorization: Bearer sg_YOUR_KEY" ``` MCP tool: `search_opportunities`Keys start free, with no card. [Get a free API key](https://samgovapi.io/sign-up) or read the [docs](https://samgovapi.io/docs). ## Related - [Opportunities API](https://samgovapi.io/sam-gov-opportunities-api) - [Alerts](https://samgovapi.io/docs/alerts)Updated 2026-11-12. Sources checked 2026-11-12.Independent. Not affiliated with, endorsed by or sponsored by GSA, SAM.gov or any U.S. government agency. Registering in SAM.gov is free at sam.gov.

---

HTML version: https://samgovapi.io/docs/opportunities . Markdown: https://samgovapi.io/docs/opportunities.md

Independent. Not affiliated with, endorsed by or sponsored by GSA, SAM.gov or any U.S. government agency. Registering in SAM.gov is free at sam.gov.

Get a free API key: https://samgovapi.io/sign-up?ref=ai-claudebot