Sam Gov Ops

SAM.gov Operations Skill

Query the U.S. federal government's System for Award Management (SAM.gov) for:

• Entity registrations - Verify contractors, lookup UEI/CAGE codes
• Exclusions - Check debarment/suspension status
• Opportunities - Find active contract solicitations
• Contract awards - Research awarded contracts

API Endpoints

Quick Start

# 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

Commands

entity - Lookup Entity Registrations

Search 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:

• Legal business name
• UEI and CAGE codes
• Registration status (Active/Expired)
• Business types
• NAICS codes
• Address and POC info

exclusions - Check Debarment/Suspension

Search 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:

• Ineligible (Proceedings Pending)
• Ineligible (Proceedings Completed)
• Prohibition/Restriction
• Voluntary Exclusion

opportunities - Search Contract Solicitations

Find 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 - Presolicitation
• o - Solicitation
• k - Combined Synopsis/Solicitation
• r - Sources Sought
• s - Special Notice
• a - Award Notice
• u - Justification and Approval

contracts - Search Awarded Contracts

Research 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"

Use Cases

OSINT / Due Diligence

# Verify a contractor is registered and not excluded
./run.sh entity --name "Acme Corp" --status active
./run.sh exclusions --name "Acme Corp"

Competitive Intelligence

# 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"

Compliance Verification

# Check if vendor is debarred before award
./run.sh exclusions --uei "ABC123DEF456" --json

Market Research

# Find all cybersecurity solicitations
./run.sh opportunities --keyword "cybersecurity" --naics 541519 --days 90

Environment Variables

# Required: SAM.gov API key
SAMGOV_API_KEY=your_public_api_key

# Optional: Use alpha/test environment
SAMGOV_USE_ALPHA=true

Getting an API Key

1. Register at SAM.gov
2. Go to Account Details > Public API Key
3. Generate a new key
4. Add to .env as SAMGOV_API_KEY

Rate Limits

Integration with Dogpile

SAM.gov is available as an OSINT source in dogpile:

# Enable SAM.gov in OSINT preset
dogpile search "Contractor XYZ" --preset osint

API Documentation

• Entity API
• Exclusions API
• Opportunities API
• Contract Awards API