GovCon API

Capabilities

Everything the API exposes, what you can build with it, and which plan you need. Each section has concrete use cases, the endpoints involved, the tier required, and a working code sample.

Need the technical reference? See /api-guide. Looking to sign up? /pricing.

Data the API exposes

The read-only surface over public federal procurement data. Most are available on the Free Trial and Developer tiers.

Contract Notices

Free Trial Developer Pro

Every federal contract notice from SAM.gov, normalized into clean JSON: solicitations, presolicitations, combined synopses, sources sought, sole source, modifications, award notices. ~223K total records, 47K Award Notices. Refreshed twice daily. This is the pre-award notice layer; for post-award FPDS contract transactions and modification trails, see Contract Intelligence below.

What you can build

  • Bid-discovery alerts on NAICS / agency / set-aside combinations
  • Set-aside-targeted RFP feeds (8(a), HUBZone, WOSB, SDVOSB)
  • Keyword + due-date search across active solicitations
  • CSV export for analyst workflows (15 exports/day on Developer)
  • Delta sync to keep an internal index up to date without re-downloading

Endpoints

GET /api/v1/opportunities/search
GET /api/v1/opportunities/{notice_id}
GET /api/v1/opportunities/delta?since=YYYY-MM-DDTHH:MM:SSZ
GET /export.csv
curl -H "Authorization: Bearer $API_KEY" \
  "https://govconapi.com/api/v1/opportunities/search?naics=541330&state=CA&limit=10"

API reference · SAM.gov API guide

Contract Intelligence

Developer Pro

Every federal prime contract transaction: who won, how much, from which agency, under which vehicle, when. Base award and every modification. Recipient UEI, parent UEI, PIID, agency hierarchy, NAICS, set-aside, period of performance, obligation amount, ceiling. Sourced from the federal procurement system of record (FPDS) for award types A, B, C, and D.

What you can build

  • Past-performance research: who has won similar work in this NAICS
  • Win-rate dashboards tracking competitors by agency and NAICS
  • Modification-trail reconstruction for one PIID over its life
  • Recipient profiles aggregating obligations across every contract a UEI holds
  • Corporate roll-up by parent UEI across subsidiaries

Endpoints

GET /api/v1/contracts/search                       # filter by UEI, PIID, agency, NAICS, award type
GET /api/v1/contracts/{piid}                       # latest action + transaction rollup
GET /api/v1/contracts/{piid}/modifications         # full ASC-ordered transaction trail
curl -H "Authorization: Bearer $API_KEY" \
  "https://govconapi.com/api/v1/contracts/search?naics=541330&amount_min=1000000&limit=20"

API reference · Contracts API guide

Full Descriptions

Free Trial Developer Pro

Full opportunity descriptions, the long-form text that explains what the contracting officer actually wants. SAM.gov doesn't return these in their API or bulk CSV. We collect them so your AI / proposal tool / search index has the actual text. ~85% coverage across active notices.

What you can build

  • Semantic search and AI summarization. RAG pipelines that need actual text.
  • Proposal-matching tools comparing your past performance to description text
  • Keyword-and-context filtering beyond NAICS / PSC

Returned as the description_text field on every /api/v1/opportunities/* response. No separate endpoint.

Note: Coverage is ~85% of active notices. The description_text field is null on records SAM serves with access controls or JS-only rendering.

API reference

Exclusions Database

Free Trial Developer Pro

Every debarred and suspended entity on the federal exclusion list. ~163K records. Search by name, UEI, CAGE, agency, state, exclusion type, country. Required reading before teaming, subcontracting, or buying parts.

What you can build

  • Pre-contract screening by UEI before sign-off
  • Vendor onboarding flows with an exclusions check baked in
  • Agency-specific risk scans (DLA, USN, GSA, etc.)
  • Country and address-based reviews to spot patterns

Endpoints

GET /api/v1/exclusions/search
GET /api/v1/exclusions/{uei}
curl -H "Authorization: Bearer $API_KEY" \
  "https://govconapi.com/api/v1/exclusions/search?uei=ABCD12345678"

API reference · Exclusions guide

SAM Entity Registry

Developer Pro

Every SAM-registered firm authorized to do business with the US federal government. ~873K legal entities, ~880K registrations. Lookup by UEI or CAGE; search by name. Returns registration status, expiration date, address, NAICS, PSC, business-type certifications, CAGE codes. Refreshed monthly.

What you can build

  • Compliance check before contract sign-off (active? expiring?)
  • CRM enrichment: paste a UEI, populate name, address, NAICS, certifications
  • Vendor-onboarding form auto-fill from UEI
  • UEI-to-CAGE bridge for legacy DoD systems
  • CAGE reverse lookup (packing slip has a CAGE, who is this)

Endpoints

GET /api/v1/entities/{uei}
GET /api/v1/entities/by-cage/{cage_code}
GET /api/v1/entities/search?q=NAME
curl -H "Authorization: Bearer $API_KEY" \
  "https://govconapi.com/api/v1/entities/XX2WFHJEFB45"
Note: Self-cert business types (27=Self-Cert SDB, 8W=Self-Cert WOSB, QF=SDVOSB) are what's available in the Public V2 SAM data. For SBA-administered cert programs (8(a), HUBZone, SBA-cert SDB), pair with SBA's DSBS as a separate source.

API reference · UEI Lookup guide · CAGE Code Lookup guide

Federal Buyer Intelligence

Free Trial Developer Pro (unlimited)

Contracting officer contact info embedded on every contract notice: name, email, phone, title. The contacts come free with each opportunity you query, on every tier. Pro adds unlimited access to extended profiles via GovCon Contacts: past performance per CO, full profiles, deeper search.

What you can build

  • BD outreach tools surfacing the right CO for a NAICS or agency
  • Contract administration workflows with CO contact pre-filled
  • "Who buys what" intelligence: which COs run the most notices in your space

Endpoints

Embedded in /api/v1/opportunities/* responses (all tiers, free)
Extended profiles at contacts.govconapi.com (Pro, unlimited)

API reference

Attachments

Free Trial Developer Pro

SOWs, RFP documents, amendments, and supporting files for every contract notice that has them. Direct download URLs. Filter to find only notices with attachments.

What you can build

  • Document analysis pipelines (OCR, LLM extraction)
  • Proposal preparation: download all amendments to a solicitation in one call
  • "Has attachments" filtering to skip notices without docs

Endpoints

GET /api/v1/opportunities/{notice_id}/attachments
Filter: has_attachments=true on /opportunities/search (Developer)
curl -H "Authorization: Bearer $API_KEY" \
  "https://govconapi.com/api/v1/opportunities/{notice_id}/attachments"

API reference

Pro products

Higher-tier capabilities at $39/mo. Each one chains the data above into a workflow that's hard to build from primitives.

Company Intelligence API

Pro

Combined SAM registration profile + award history per UEI in one call. Returns 200 for any of the ~873K SAM-registered firms (not just the ~11K that have won contracts). Award fields populate when the UEI has Award Notices on file; otherwise they zero out and the registration / entity blocks still populate.

What you can build

  • Compliance + due diligence in one call (active, expiration, totals, top agencies, top NAICS)
  • Customer concentration analysis via top_agencies
  • Pipeline health checks (awards_last_90d vs awards_last_12mo)
  • Capability mapping via top_naics (what they win, not what they claim)
  • Peer / competitor discovery via /peers ranked by NAICS + agency overlap

Endpoints

GET /api/v1/companies/{uei}
GET /api/v1/companies/{uei}/awards
GET /api/v1/companies/{uei}/peers
GET /api/v1/companies/search?q=NAME
curl -H "Authorization: Bearer $API_KEY" \
  "https://govconapi.com/api/v1/companies/XX2WFHJEFB45"
# → { "uei": "...", "name": "...", "total_awards": 868,
#     "top_agencies": [...], "registration": {...}, "entity": {...} }

API reference · Company Intelligence API guide

Renewal Radar

Pro

Active SAM registrations expiring within N days, sorted by urgency. Filter by state or NAICS. The renewal-monitoring use case: SAM registrations expire annually; lapsed registrations make a firm invisible to contracting officers and ineligible for award.

What you can build

  • Compliance dashboards flagging subcontractors whose SAM lapses in N days
  • Renewal-reminder SaaS with targeted email campaigns
  • BD pipeline early-warning (a firm not renewing = opportunity for replacement)
  • Renewal-services consulting lead generation by state + NAICS
  • Internal supplier-onboarding workflow with quarterly check on approved suppliers

Endpoints

GET /api/v1/entities/expiring?within_days=N&state=&naics=
curl -H "Authorization: Bearer $API_KEY" \
  "https://govconapi.com/api/v1/entities/expiring?within_days=30&state=DC&limit=20"
# → 391 DC-based firms expiring in next 30 days, most-urgent first

API reference · Expiration Checker guide

Vendor Risk Intelligence API

Pro

7-signal screening per UEI. Beyond a single-UEI exclusion check: address-cluster, name-variant cluster, coordinated enforcement-wave membership, last-award-to-debarment timing, and more. Plus a triage verdict for fast classification.

What you can build

  • Subcontractor vetting workflows for prime contractors
  • Bulk vendor screening (POST up to 100 UEIs per request)
  • "Why is this risky" explanations: each signal returns underlying records
  • Pattern-detection dashboards (DLA enforcement waves)
  • Compliance reports for FAR-driven supplier reviews

Endpoints

GET  /api/v1/vendor-risk/{uei}
POST /api/v1/vendor-risk/bulk
curl -H "Authorization: Bearer $API_KEY" \
  "https://govconapi.com/api/v1/vendor-risk/N4PXS6S8HNU4"
# → { "triage": {"verdict": "high", ...}, "signals": [...] }

API reference · Vendor Risk Intelligence API guide · Free public lookup

Federal Subawards (FFATA) API

Pro

Every FFATA Section 2 report: who paid whom under each prime contract. Map any prime's supply chain, see the real federal revenue of small businesses (sub income is often the larger half), trace prime-to-sub flow per contract. Coverage today: FY2025 + FY2026 (October 2024 onward) from USAspending, refreshed daily.

What you can build

  • Supply-chain maps for any prime contractor (subs paid, top counterparties, dollar flow)
  • True-revenue picture for SMBs (combined prime + sub revenue, with concentration ratio)
  • Set-aside flow-down compliance reviews (where did the small-business set-aside dollars actually go?)
  • Compliance smoking-gun screens: surface excluded entities that are still receiving sub payments
  • M&A diligence on a target's customer concentration and counterparty risk

Endpoints

GET /api/v1/subawards/search                       # filter by prime UEI, sub UEI, PIID, agency, NAICS
GET /api/v1/subawards/{subaward_sam_report_id}     # single FFATA report
GET /api/v1/companies/{uei}/subawards              # subs paid by this prime
GET /api/v1/companies/{uei}/prime-relationships    # primes that paid this sub

Plus inline enrichment on existing endpoints

Pro responses on /contracts/{piid}, /companies/{uei}, /entities/{uei}, /vendor-risk/{uei}, and /exclusions/{uei_sam} add subaward context inline so you don't need a second round-trip. The PIID join on /contracts/{piid} is dense (~88% of FY2025+ subaward filings match a prime contract row). FPDS prime contract context lands on the same surfaces in parallel: fpds_obligated_total, fpds_distinct_contracts, and fpds_top_agencies on /companies/{uei} and /entities/{uei}; a contract_exposure block on /vendor-risk/{uei}; a recent_contract_actions block on /exclusions/{uei_sam} for the "is this excluded UEI still being paid directly?" question. Silently omitted on non-Pro keys; existing integrations keep working unchanged.

curl -H "Authorization: Bearer $API_KEY" \
  "https://govconapi.com/api/v1/companies/ZMXAHH8M8VL8/subawards?limit=20"
# → { "summary": { "prime_name": "OSHKOSH DEFENSE, LLC",
#                  "total_subaward_amount": 413361154,
#                  "distinct_sub_vendors": 264,
#                  "distinct_prime_contracts": 372, ... }, ... }

API reference · Subawards API guide

Developer experience

Cross-cutting tooling for working with the API.

MCP for Claude / Cursor

Free Trial Developer Pro

Federal contracts data inside Claude Desktop, Claude Code, Cursor, ChatGPT, or any MCP-compatible client. The package wraps a curated set of API endpoints as MCP tools so you can ask in natural language. Currently exposes 6 tools covering opportunities, awards, exclusions, and the agency crosswalk; entities and Pro endpoints are accessible via the HTTP API directly.

What you can build

  • Conversational research in your IDE or Claude app, no SDK to write
  • AI agent workflows that pull live federal data while writing your bid
  • Quick-and-dirty BD queries from Claude Desktop without opening a browser

Install

# Get an API key first at https://govconapi.com
pipx install govconapi-mcp

# Add to your MCP client config (Claude Desktop example):
# "govconapi": {
#   "command": "govconapi-mcp",
#   "env": { "GOVCONAPI_KEY": "gca_..." }
# }

Setup guide

Plans

Free Trial
$0, 14 days, no credit card

25 requests/day on Free Trial endpoints. Try before you commit.

Developer
$19/mo

1,000 req/hr. Opportunities + awards + exclusions filters, full SAM entity lookup (UEI/CAGE/name), CSV exports, MCP, descriptions.

Pro
$39/mo · best value

Everything Developer plus Company Intelligence API, multi-filter entity search, Renewal Radar, Vendor Risk Intelligence API, Federal Subawards (FFATA) API, unlimited GovCon Contacts.

View pricing & subscribe →