sam-gov-api

Query SAM.gov APIs for entity registrations, exclusions, opportunities, and contract awards.

Updated Apr 14, 2026
One-click install
npx skills add https://github.com/BdM-15/shipley-bd-capture-skills --skill sam-gov-api
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sam-gov-api
Source: https://github.com/BdM-15/shipley-bd-capture-skills/tree/main/govcon-skills/sam-gov-api
Command: npx skills add https://github.com/BdM-15/shipley-bd-capture-skills --skill sam-gov-api

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Public SAM.gov data sources for entity registration, exclusions, opportunities, and contract awards are dispersed and require multiple lookups; this skill consolidates access to these domains to streamline due diligence and market research.

Core Features & Use Cases

  • Unified SAM.gov API access for entity management, exclusions, opportunities, and awards.
  • Normalized responses and robust parameter handling (ueiSAM, cageCode, piid, ncode, ccode, date ranges) to support vendor due diligence and opportunity tracking.
  • Use Case: Quickly verify a vendor's registration status and exclusions before submitting a bid, and trace contract awards for competitive analysis.

Quick Start

Look up a vendor's UEI and retrieve its registration status and core data to begin due diligence.

Frequently Asked Questions about sam-gov-api

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I retrieve SAM.gov entity registration and exclusion records for due diligence?

To retrieve SAM.gov entity registration and exclusion records, you query the respective APIs using a vendor's UEI or CAGE code. This consolidated skill normalizes the responses, allowing you to quickly verify registration status and check for exclusions.

Can I look up federal contract awards and opportunities using a PIID?

Yes, you can look up federal contract awards and opportunities using a PIID. The skill accepts standard search parameters including piid and date ranges to trace specific contract award histories and track relevant procurement opportunities.

Do I need an API key to query federal procurement data for contract awards?

Yes, you need a SAM.gov API key to query federal procurement data. The skill requires this key to authenticate requests across entity management, exclusions, opportunities, and contract awards domains for your due diligence research.

What is the best way to handle inconsistent SAM.gov API responses for vendor lookups?

The best way to handle inconsistent SAM.gov API responses is to use a normalization process. This skill automatically standardizes varying response wrappers and paginates results, ensuring reliable downstream processing for UEI and CAGE lookups.

Does this SAM.gov data skill support filtering contract opportunities by NAICS or PSC codes?

Yes, the skill supports filtering contract opportunities by classification codes. It handles common search parameters such as ncode and ccode, alongside date ranges, to narrow down federal procurement opportunity tracking and market research.

What are the limitations of using SAM.gov APIs for entity management and due diligence?

A limitation of using SAM.gov APIs is managing pagination and inconsistent response wrappers across dispersed data domains. This skill mitigates these constraints by normalizing outputs, though users must still provide their own API key for access.