Search one dataset. `filters` holds that dataset's filters; an unknown filter returns the full list.
Agency values come from resolve(agency), NAICS codes from resolve(naics), UEIs from resolve(company).
Dates are YYYY-MM-DD. (Pro) marks datasets that need the Pro plan. Keep `limit` small (20-50) and page with
`offset`: rows are large. Only opportunities, forecasts and partners take `keywords`.
- opportunities: SAM.gov notices. naics, psc, agency, keywords, state, set_aside (HUBZone, WOSB, 8(a), Veteran,
Small Business), notice_type (Solicitation, Combined Synopsis/Solicitation, Presolicitation, Sources Sought,
Award Notice), posted_after, due_before, due_after, value_min, value_max;
sort_by: posted_date | due_date | award_amount | title | agency | relevance
- opportunity_changes: notices added or changed since a time. since (ISO timestamp, required); no other filters
- forecasts: work agencies plan to buy. agency, naics, set_aside, state, est_award_fy, keywords, is_recompete,
source (fco | dhs | hhs); sort_by: est_award_fy | est_solicitation_date | value_high | agency
- award_notices: SAM.gov award announcements. awardee, uei, naics, agency, value_min, value_max, date_from, date_to
- contracts: FPDS awards. naics, agency, uei, piid, award_type_code (A | B | C | D), date_from, date_to,
amount_min, amount_max; sort_by: action_date | current_total_value_of_award | federal_action_obligation |
recipient_name. Find a named vehicle's orders with parent_piid
- vehicles: IDIQs, GWACs, GSA Schedules. Needs one of uei, piid, agency, naics, idv_type (IDC | FSS | BPA |
GWAC | BOA); active_only, ceiling_min. No name search: find a vehicle's PIID via contracts or the notice
- subawards: who subcontracts to whom. prime_uei, sub_uei, sub_name, naics, agency, piid, date_from, date_to,
amount_min; sort_by: subaward_action_date | subaward_amount
- recompetes (Pro): contracts ending soon. naics, agency, set_aside, state, ends_within_months, amount_min;
sort_by: ends_soonest | value | mod_churn | de_obligated
- companies (Pro): firms with award history, by name. q (name, REQUIRED), naics, agency, naics_small.
Ranking firms without a name ("who wins this work") is partners
- entities: every SAM registration. q (name), naics, state, business_type (SAM code: "8W" WOSB, "QF" SDVOSB),
naics_small (a NAICS the firm is SBA-small for), active_only
- expiring_registrations (Pro): SAM registrations about to lapse. within_days, state, naics
- partners (Pro): firms ranked by dollars won (FY2025 onward) in a NAICS, agency, state or PSC: who wins
this work, the incumbents, teaming candidates. naics, agency, state, psc, keywords,
set_aside (sdvosb | vosb | wosb | hubzone | 8a | sdb | minority_owned)
- protests: GAO bid protests. agency, protester, status (Open | Closed), outcome (Denied | Dismissed | Sustained |
Withdrawn), filed_from, filed_to; sort: recent | oldest | filed | due
- exclusions: debarred or suspended parties. name, uei, cage_code
- wage_determinations: type (SCA | DBA | CBA), state (2 letters), county, wd_number, active_only
- wage_determinations_by_location: every determination for a place. state (2 letters, required), county, type
- offices: contracting offices that buy a NAICS. naics (required); sort: biggest | most_open