SAM.gov readiness, entities, exclusions, opportunities, awards, hierarchy, and subawards. 20 tools.
Score is being calculated.
Report source file names and dates, load times, row counts and coverage limitations for public opportunities, entity registrations and exclusions. Includes opportunity counts by type and last-load changes. Use it to judge how current results are.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Get one SAM.gov notice in full: description, response deadline, set-aside, NAICS and PSC codes, place of performance, contracting office, points of contact, award details for award notices, and the public sam.gov link. Also lists other active notices with the same solicitation number, such as earlier versions, amendments, or awards (with awardee and amount).
Pass the 32-character notice ID from search results, or a solicitation number (returns its most recently posted current notice, preferring the solicitation over award notices and justifications). Attachments are not retrieved; open the sam.gov link for them.
| Name | Required | Description | Default |
|---|---|---|---|
| notice_id | No | 32-character SAM.gov notice ID. | |
| solicitation_number | No | Solicitation number, used when notice_id is not given. |
Answer SAM registration and socioeconomic questions: women-owned/WOSB/EDWOSB, veteran-owned/SDVOSB, HUBZone, 8(a), and small business. Search the monthly public extract by UEI, CAGE, name, NAICS and state; filters combine. any_naics includes secondary codes. Search defaults Active; UEI/CAGE includes inactive. Use the labeled business or SBA code filters below. For NAICS-specific small-business status, request assertions or All and check sbaSmallBusiness; 2X means for-profit, not small. Codes and active registration do not prove current SBA certification; check certificationExitDate and confirm SBA/SAM.gov status. Public-display opt-outs are excluded. Up to 10 records/page.
| Name | Required | Description | Default |
|---|---|---|---|
| uei | No | Exact 12-character UEI. | |
| page | No | ||
| size | No | ||
| any_naics | No | Any listed NAICS, 2-6 digits. | |
| cage_code | No | Exact 5-character CAGE code. | |
| state_code | No | Physical address state, 2-letter USPS code. | |
| primary_naics | No | Designated primary NAICS, 2-6 digits. | |
| include_sections | No | Public sections only. Defaults to entityRegistration + coreData; entityRegistration is always included. | |
| business_type_code | No | SAM business-type codes; ownership is generally self-selected, not SBA certification. Common codes: A2=Woman-Owned Business; 8W=Women-Owned Small Business; A5=Veteran-Owned Business; QF=Service-Disabled Veteran-Owned Business; 23=Minority-Owned Business; 27=Self Certified Small Disadvantaged Business; 8C=Women-Owned Small Business (WOSB) Joint Venture eligible under the WOSB Program; 8D=Economically Disadvantaged Women-Owned Small Business (EDWOSB) Joint Venture; JV=Service-Disabled Veteran-Owned Business Joint Venture; JX=Self-Certified HUBZone Joint Venture; JS=Small Business Joint Venture; FR=Asian-Pacific American Owned; QZ=Subcontinent Asian (Asian-Indian) American Owned; OY=Black American Owned; PI=Hispanic American Owned; NB=Native American Owned; OW=American Indian Owned; 05=Alaskan Native Corporation Owned Firm; 8U=Native Hawaiian Organization Owned Firm; 1B=Tribally Owned Firm; 1E=Indian Economic Enterprise; 1S=Indian Small Business Economic Enterprise; XY=Indian Tribe (Federally Recognized); HK=Community Development Corporation Owned Firm; HQ=DOT Certified DBE; A7=AbilityOne Non-Profit Agency; 1D=Small Agricultural Cooperative; A8=Non-Profit Organization; H2=Community Development Corporation; HB=Historically Black College or University; 1A=Minority Institution; HS=Tribal College; GW=Hispanic Servicing Institution. Other official 2-character business codes are accepted. | |
| legal_business_name | No | Partial legal or DBA name; punctuation, spacing, ampersands and common company suffixes are normalized. Zero results include separately labeled possible name matches; names alone do not confirm identity. | |
| registration_status | No | A=Active (search default), E=expired (displayed as Inactive). | |
| sba_business_type_code | No | SBA source codes: A6=SBA Certified 8(a) Program Participant; JT=SBA Certified 8(a) Joint Venture; XX=SBA Certified HUBZone Firm; A4=SBA Certified Small Disadvantaged Business (No longer Active); A9=SBA-Certified Women-Owned Small Business; A0=SBA-Certified Economically Disadvantaged Women-Owned Small Business. A4 is retired. These are monthly source codes, not proof of current certification; check certificationExitDate and confirm with SBA. | |
| purpose_of_registration | No |
Check SAM.gov public exclusion/debarment records by UEI, CAGE, or name. Filters combine. Searches the dated public extract, which is not a complete exclusion history; inactive or terminated historical records may be absent. Every result identifies the source file and date. No matches in the extract is not a live clearance or eligibility determination; confirm current status on SAM.gov.
| Name | Required | Description | Default |
|---|---|---|---|
| uei | No | 12-character Unique Entity ID; exact match. | |
| page | No | ||
| size | No | ||
| country | No | 3-character ISO alpha-3 country code, e.g. USA. | |
| cage_code | No | 5-character CAGE; exact match. | |
| entity_name | No | Partial firm or individual name; punctuation, spacing, ampersands and common company suffixes are normalized, including first/middle/last names. Zero results include separately labeled possible name matches; names alone do not confirm identity. | |
| classification | No | ||
| state_province | No | ||
| exclusion_program | No | ||
| excluding_agency_code | No |
Search active SAM.gov contract opportunity notices: solicitations, combined synopses, presolicitations, sources sought, special notices, award notices, and justifications.
All filters combine. Keyword search covers titles and full descriptions. By default, only the latest version of each amended notice is included. Notices whose response deadline has passed are left out, except award notices and justifications; notices with no deadline are also included. Set include_past_deadlines to true to include other past-deadline notices. Results are sorted by soonest deadline, with notices that have no deadline last. Returns up to 100 notices per call with the total match count; use offset to page. Use get_opportunity for a notice's full description and contacts.
Data is SAM.gov's public daily file of active notices, not live SAM.gov. Archived notices and attachments are not included.
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | deadline: soonest response deadline first. newest: most recently posted first. relevance: best keyword match first (needs keywords). | deadline |
| limit | No | ||
| agency | No | Text matched against the department, sub-tier, and office names, e.g. Army, Veterans Affairs, NSWC Dahlgren. Field activities post under their own office names, so a command name matches only its headquarters office (NAVSEA matches NAVSEA HQ, not NSWC or NUWC offices). | |
| offset | No | ||
| keywords | No | Words that must all appear in the title or full description. Put exact phrases in double quotes, e.g. zero trust "cloud migration". Word endings are matched loosely (bridge matches bridges). | |
| posted_to | No | Latest posted date, YYYY-MM-DD. | |
| psc_codes | No | Product and service codes or prefixes, e.g. D3 or R425. | |
| deadline_to | No | Latest response deadline date, YYYY-MM-DD. | |
| naics_codes | No | NAICS codes or prefixes (2 to 6 digits); a prefix such as 5415 matches every code under it. | |
| posted_from | No | Earliest posted date, YYYY-MM-DD. | |
| notice_types | No | Current notice types to include. Omit for all types. | |
| office_state | No | Two-letter state code of the contracting office. Filled in on nearly every notice, but an office's state is not always where the work happens. | |
| deadline_from | No | Earliest response deadline date, YYYY-MM-DD, in the deadline's own time zone. | |
| set_aside_codes | No | SAM.gov set-aside codes, e.g. SBA (total small business), 8A, SDVOSBC, WOSB, HZC. NONE means the notice says no set-aside was used. | |
| solicitation_number | No | Exact solicitation number. | |
| include_past_deadlines | No | Include notices whose response deadline has already passed. SAM.gov keeps notices active for a while after the deadline; by default they are left out. Award notices and justifications are always included, even when they list a past deadline, and so are notices with no deadline. | |
| include_earlier_versions | No | Include earlier versions of amended notices. SAM.gov's file lists every version of a notice as its own row; by default only the latest version of each is included. | |
| place_of_performance_state | No | Two-letter state code for the place of performance. Most notices leave the place of performance blank, so results also report how many more notices have a contracting office in that state (see office_state). |
Count active SAM.gov notices grouped by agency, sub-tier, office, NAICS, PSC, set-aside, notice type, place-of-performance state, contracting office state, or posted month. Accepts the same filters as search_opportunities, e.g. counts of open solicitations under one NAICS by set-aside, or which agencies posted the most sources sought notices this quarter.
Counts cover active notices in SAM.gov's public daily file, including notices posted in earlier fiscal years that remain active. This is not a complete historical archive; archived notices are not included.
| Name | Required | Description | Default |
|---|---|---|---|
| top | No | Number of groups to return, largest first. For posted_month, the most recent months, in month order. | |
| agency | No | Text matched against the department, sub-tier, and office names, e.g. Army, Veterans Affairs, NSWC Dahlgren. Field activities post under their own office names, so a command name matches only its headquarters office (NAVSEA matches NAVSEA HQ, not NSWC or NUWC offices). | |
| group_by | Yes | Field to group counts by. | |
| keywords | No | Words that must all appear in the title or full description. Put exact phrases in double quotes, e.g. zero trust "cloud migration". Word endings are matched loosely (bridge matches bridges). | |
| posted_to | No | Latest posted date, YYYY-MM-DD. | |
| psc_codes | No | Product and service codes or prefixes, e.g. D3 or R425. | |
| deadline_to | No | Latest response deadline date, YYYY-MM-DD. | |
| naics_codes | No | NAICS codes or prefixes (2 to 6 digits); a prefix such as 5415 matches every code under it. | |
| posted_from | No | Earliest posted date, YYYY-MM-DD. | |
| notice_types | No | Current notice types to include. Omit for all types. | |
| office_state | No | Two-letter state code of the contracting office. Filled in on nearly every notice, but an office's state is not always where the work happens. | |
| deadline_from | No | Earliest response deadline date, YYYY-MM-DD, in the deadline's own time zone. | |
| set_aside_codes | No | SAM.gov set-aside codes, e.g. SBA (total small business), 8A, SDVOSBC, WOSB, HZC. NONE means the notice says no set-aside was used. | |
| solicitation_number | No | Exact solicitation number. | |
| include_past_deadlines | No | Include notices whose response deadline has already passed. SAM.gov keeps notices active for a while after the deadline; by default they are left out. Award notices and justifications are always included, even when they list a past deadline, and so are notices with no deadline. | |
| include_earlier_versions | No | Include earlier versions of amended notices. SAM.gov's file lists every version of a notice as its own row; by default only the latest version of each is included. | |
| place_of_performance_state | No | Two-letter state code for the place of performance. Most notices leave the place of performance blank, so results also report how many more notices have a contracting office in that state (see office_state). |
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
get_data_statusget_opportunitysearch_entitiessearch_exclusionssearch_opportunitiessummarize_opportunitiesSix tools over US federal procurement: SAM.gov, FPDS awards, entities, subawards, exclusions.
SAM.gov contracts and USAspending awards. 4 procurement tools.
SAM.gov contract opportunities and entity lookup (BYOK) plus USASpending federal award data.
55 tools for federal/state/local RFPs, awards, vendors, contact graph, contract vehicles, pursuits.
Add one secure layer between your agents and this server.