Smithery is now a part of Arcade.dev! Read more in our announcement here
Query SAM.gov for federal contracts, entity registrations, exclusions, and opportunities. Uses official GSA APIs for government contractor intelligence and OSINT research.
Query the U.S. federal government's System for Award Management (SAM.gov) for:
| API | Purpose | Rate Limit |
|---|---|---|
| Entity API | Contractor registrations, UEI/CAGE lookup | 1,000/day |
| Exclusions API | Debarred/suspended entities | 1,000/day |
| Opportunities API | Active solicitations | 1,000/day |
| Contract Awards API | Awarded contracts | 1,000/day |
# Set API key (or use .env)
export SAMGOV_API_KEY="your_api_key"
# Lookup entity by name
./run.sh entity --name "Lockheed Martin"
# Lookup entity by UEI
./run.sh entity --uei "EXAMPLEUEI123"
# Check exclusions (debarment)
./run.sh exclusions --name "John Doe"
# Search opportunities
./run.sh opportunities --keyword "cybersecurity" --days 30
# Search contracts
./run.sh contracts --agency "DOD" --naics 541512
entity - Lookup Entity RegistrationsSearch for registered government contractors.
# By business name
./run.sh entity --name "Raytheon"
# By UEI (Unique Entity Identifier)
./run.sh entity --uei "ABC123DEF456"
# By CAGE code
./run.sh entity --cage "1ABC2"
# Filter by registration status
./run.sh entity --name "Boeing" --status active
# Output as JSON
./run.sh entity --name "Boeing" --json
Response includes:
exclusions - Check Debarment/SuspensionSearch the federal exclusions list.
# By name (individual or firm)
./run.sh exclusions --name "Smith"
# By classification
./run.sh exclusions --classification Firm
./run.sh exclusions --classification Individual
# By excluding agency
./run.sh exclusions --agency DOJ
# By state
./run.sh exclusions --state VA
# Active exclusions only
./run.sh exclusions --name "Corp" --active-only
Exclusion types:
opportunities - Search Contract SolicitationsFind active federal contracting opportunities.
# Keyword search
./run.sh opportunities --keyword "artificial intelligence"
# By NAICS code
./run.sh opportunities --naics 541512
# By procurement type
./run.sh opportunities --type p # Presolicitation
./run.sh opportunities --type o # Solicitation
./run.sh opportunities --type a # Award Notice
# By set-aside type
./run.sh opportunities --set-aside SBA
# Combine filters
./run.sh opportunities --keyword "cloud" --naics 541519 --days 60
Procurement types:
p - Presolicitationo - Solicitationk - Combined Synopsis/Solicitationr - Sources Soughts - Special Noticea - Award Noticeu - Justification and Approvalcontracts - Search Awarded ContractsResearch federal contract awards.
# By agency
./run.sh contracts --agency "DEPT OF DEFENSE"
# By contractor name
./run.sh contracts --contractor "Northrop Grumman"
# By NAICS
./run.sh contracts --naics 541330
# By date range
./run.sh contracts --from 2024-01-01 --to 2024-12-31
# By award type
./run.sh contracts --type "DEFINITIVE CONTRACT"
# Verify a contractor is registered and not excluded
./run.sh entity --name "Acme Corp" --status active
./run.sh exclusions --name "Acme Corp"
# Find what contracts a competitor has won
./run.sh contracts --contractor "Palantir" --from 2024-01-01
# Find opportunities in a specific sector
./run.sh opportunities --naics 541512 --keyword "cloud migration"
# Check if vendor is debarred before award
./run.sh exclusions --uei "ABC123DEF456" --json
# Find all cybersecurity solicitations
./run.sh opportunities --keyword "cybersecurity" --naics 541519 --days 90
# Required: SAM.gov API key
SAMGOV_API_KEY=your_public_api_key
# Optional: Use alpha/test environment
SAMGOV_USE_ALPHA=true
.env as SAMGOV_API_KEY| User Type | Daily Limit |
|---|---|
| Non-federal (no role) | 10 requests |
| Non-federal (with role) | 1,000 requests |
| Federal user | 1,000 requests |
| Federal system account | 10,000 requests |
SAM.gov is available as an OSINT source in dogpile:
# Enable SAM.gov in OSINT preset
dogpile search "Contractor XYZ" --preset osint
