GovCon APIGovCon API capabilities by plan
Every dataset and everything we build on it, with the endpoints that serve it and the fields Pro adds. One API key covers all of it, over REST and MCP; your plan decides what the key can call.
How the plans divide
- Developer gets the federal record: every dataset as the government publishes it. Four things we build come with it: Contracting Offices, NAICS Markets, Spending and the reference lookups.
- Pro gets everything in Developer, plus the rest of what we build on it and Pro fields: computed fields added to several federal records.
- The free trial gets what Developer gets, except GSA Schedule Labor Rates. How long it lasts and how far back its search reaches are on Pricing.
Every search filter is on every plan that can call the endpoint, including filters on data we assemble: any
plan can find the firms SBA counts as small for a NAICS, and receiving their SBA profile is Pro. The one Pro
search parameter is content, which searches inside attachments.
Coverage, record counts and freshness for each dataset are on Data, and which plan includes each capability, row by row, is the comparison table on Pricing.
The federal record
Datasets as the government publishes them.
Contract Opportunities
SAM.gov contract notices, from sources sought to award notices, with the description text, the points of contact and links to their attachment files. Delta sync returns every notice added or updated since a time you pass, within the last 60 days.
Endpoints: /api/v1/opportunities/search, /api/v1/opportunities/{notice_id},
/api/v1/opportunities/delta, /api/v1/opportunities/{notice_id}/; award notices
at /api/v1/awards/search, /api/v1/awards/{award_number}
How SAM.gov's own API works, from registration to its rate limits and common issues, is in the SAM.gov API guide.
Federal Contracts
FPDS prime contract transactions: who won, how much was obligated, which agency awarded it, and every modification to a contract, plus the vehicle an order was placed against.
Pro adds: on contract detail, the subaward rollup: which subcontractors the prime reported paying under that contract.
Endpoints: /api/v1/contracts/search, /api/v1/contracts/{piid},
/api/v1/contracts/{piid}/, /api/v1/contracts/{piid}/vehicle
How to walk one contract's modification trail, and the quirks to expect in FPDS records, are in the Federal Contracts guide.
Contract Vehicles
The IDIQs, GWACs, Federal Supply Schedule contracts, BPAs and BOAs that orders are placed against, one row per vehicle, searchable by holder UEI, agency, NAICS or vehicle type. One vehicle's record shows its ceiling, its ordering period and a summary of its orders.
Endpoints: /api/v1/vehicles/search, /api/v1/vehicles/{piid}; Pro:
/api/v1/vehicles/{piid}/holders, who holds a vehicle and who is actually earning through it
Why the vehicle, not the order, is where federal work is decided, with three end-to-end recipes, is in the Contract Vehicles guide.
Subawards
The subaward reports prime contractors file about payments to their subcontractors: map a prime's subcontractors, or a subcontractor's paying primes.
Endpoints: /api/v1/subawards/search, /api/v1/subawards/,
/api/v1/companies/{uei}/subawards, /api/v1/companies/{uei}/prime-relationships. The two
under /companies/ are subaward reads, open to every plan.
What prime-only contract data misses, and the reporting quirks to expect, are in the Subawards guide.
SAM Entity Registry
SAM.gov registrations keyed by UEI: registration status and expiration, CAGE codes, address, NAICS codes and self-reported business types. Look a firm up by UEI or CAGE code, or search by name, NAICS, state, business type, active registrations only, or the firms SBA counts as small for a NAICS.
Pro adds: on UEI and CAGE lookups, the firm's federal revenue: its FPDS obligated total, contract and transaction counts, first and latest action dates, subaward revenue and top paying primes. On UEI lookup, also its SBA small-business profile.
Endpoints: /api/v1/entities/search, /api/v1/entities/{uei},
/api/v1/entities/by-cage/{cage_code}
Worked searches, and how this search compares with SBA's and SAM.gov's own, are in the federal contractor search guide.
Exclusions
SAM.gov's current exclusion list: firms, individuals and other parties barred from federal awards, searchable by name, UEI, CAGE code, agency, state, classification or exclusion type.
Pro adds: on UEI lookup, the excluded party's recent contract actions and recent subaward payments.
Endpoints: /api/v1/exclusions/search, /api/v1/exclusions/{uei_sam}
Why a daily sync from SAM.gov's own API is impractical, with a compliance checklist, is in the Exclusions guide.
Wage Determinations
Davis-Bacon, Service Contract Act and collective bargaining agreement wage determinations: every active determination for a state and county, and the base wage and fringe for each trade or occupation.
Endpoints: /api/v1/wage-determinations/search, /api/v1/wage-determinations/by-location,
/api/v1/wage-determinations/rates, /api/v1/wage-determinations/rate-summary,
/api/v1/wage-determinations/{wd_id}
How SAM.gov structures determinations, and where the hourly rates actually live, are in the Wage Determinations guide.
Procurement Forecasts
What agencies plan to buy, published before a solicitation exists.
Pro adds: on forecasts that are recompetes, the incumbent contract; and the forecast's direct contacts: contracting officer email, point-of-contact email and phone, and small business specialist email and phone. On other plans these fields come back empty.
Endpoints: /api/v1/forecasts/search
Where the forecasts come from, and how one that replaces a contract leads to its incumbent, are in the Procurement Forecasts guide.
Bid Protests
GAO bid protests, pending and decided: who protested, on which solicitation, at which agency, when it was filed, the date GAO must decide by, and the outcome.
Endpoints: /api/v1/protests; Pro: /api/v1/protests/,
whether a specific opportunity or award is being challenged right now
How long a protest takes, when the automatic stay lifts, and why a dismissal often means the protester won are in the Bid Protests guide.
GSA Schedule Labor Rates
Awarded ceiling hourly rates on GSA Schedule contracts. Ask for a labor category and get the rate percentiles, filterable by education, experience, NAICS, vendor, worksite, business size and security clearance, with the typical out-year escalation.
Endpoints: /api/v1/pricing/labor-rates
How a ceiling rate differs from the rate you bill, and how to read a competitor's rate card, are in the GSA Schedule Labor Rates guide.
Federal Hierarchy
The federal organization tree: departments and their agencies, with each one's children and ancestors. Use it to resolve an agency name or code to one organization.
Endpoints: /api/v1/federal-hierarchy, /api/v1/federal-hierarchy/{organization_id},
/api/v1/federal-hierarchy/,
/api/v1/federal-hierarchy/
When to use it instead of the agency crosswalk is in the Federal Hierarchy vs agency crosswalk guide.
What we build on it
Records joined, computed or resolved by us. Which plan carries each one is in the comparison table on Pricing, and how most of them work is on Workflows.
Contracting Offices
Which contracting offices buy a NAICS, ranked, each with its own competition and set-aside facts rather than the market-wide average, and a profile of how one office buys and what it buys.
Endpoints: /api/v1/offices, /api/v1/offices/{office_code}
NAICS Markets
One NAICS code as a federal market: its size, active competitors, set-aside share, top buyers and incumbents, how contested it is, the words buyers use in its solicitations, and how its awards split by value band. Plus leaderboards across codes and code discovery.
Endpoints: /api/v1/naics, /api/v1/naics/{code}, /api/v1/naics/{code}/competition,
/api/v1/naics/{code}/positioning, /api/v1/naics/{code}/simplified-acquisition,
/api/v1/naics/leaderboard/{board}
The largest markets, the least concentrated and those leaning hardest on 8(a) set-asides are ranked on Market Pulse.
Spending
Where federal contract dollars go, rolled up by buying agency, by product or service code, or by set-aside program, ranked by obligations.
Endpoints: /api/v1/spending/{cut}
Recompete Watchlist
Contracts in a market entering their recompete window, with the incumbent, the option runway, how contested the work is, signs of incumbent stress and named subcontractors, plus recent sources-sought and pre-solicitation notices in the same market.
Endpoints: /api/v1/recompetes, /api/v1/recompetes/{piid}
Attachment Search
Search inside the documents attached to SAM.gov notices (statements of work, RFPs, amendments, spreadsheets and scanned PDFs) and get back the notices whose documents match.
Endpoints: /api/v1/opportunities/
Contracting Officer Contacts
Resolve a contracting officer by name, narrowed by agency or state, or by email, and get their agency, location, email and phone. It also finds a firm's own contact: the named person on its SAM registration, with third-party registration agents filtered out. Both are lookups for someone you already have in mind, not directories. The points of contact printed on each notice come with the notice on every plan.
Endpoints: /api/v1/contacts/lookup, /api/v1/company-contact/{uei}
Company Profile
One firm by UEI: its SAM registration, federal awards, subaward activity, top agencies, NAICS codes, SBA profile and peers. Or search companies by name across award records and registrations.
Endpoints: /api/v1/companies/search, /api/v1/companies/{uei},
/api/v1/companies/{uei}/awards, /api/v1/companies/{uei}/peers
SBA Small Business Profiles
SBA's profile of a small business, by UEI: the NAICS codes SBA counts it as small for, its SBA certifications (8(a), WOSB, EDWOSB, HUBZone, SDVOSB, VOSB) with entry and exit dates, kept apart from the ones the firm claims for itself, and its capabilities narrative.
Endpoints: /api/v1/dsbs/{uei}; also returned on /api/v1/entities/{uei}
and in Company Profile
Teaming Partner Finder
Firms that have won federal work in a NAICS, agency, place-of-performance state or socioeconomic category, ranked by obligated dollars, with named points of contact, each flagged if it is currently excluded.
Endpoints: /api/v1/partners/search
Vendor Risk
One UEI, or a batch of UEIs in one request, screened against the exclusion list and public-record patterns such as shared addresses, name variants and multiple CAGE codes. Every signal comes with the records behind it.
Endpoints: /api/v1/vendor-risk/{uei}, POST /api/v1/vendor-risk/bulk
Contract Price Benchmarks
The percentile range of comparable federal contract values for a NAICS, narrowed by pricing type, set-aside, product or service code and agency, and where a number you propose falls in that range, with the real contracts nearest it. A market range, not a win predictor.
Endpoints: /api/v1/pricing/benchmark, /api/v1/pricing/position
Renewal Radar
Active SAM registrations expiring within a window you choose, by state or NAICS, most urgent first: for supplier monitoring, subcontractor compliance, or finding firms about to lapse.
Endpoints: /api/v1/entities/expiring
Reference lookups
Small lookups the datasets rely on: translate a legacy DUNS number to its UEI, search the Product and Service Code catalog, download the standardized agency list, read every dataset's status, and check your own key. The agency list and the status endpoint need no key.
Endpoints: /api/v1/identifiers/{identifier}, /api/v1/psc/search,
/api/v1/psc/{code}, /api/agency-crosswalk, /api/v1/status,
/api/v1/me
Two ways in
Every capability above is an endpoint on the REST API: one bearer key, JSON back. The API guide documents each endpoint's parameters and response fields.
The MCP server exposes a selected set of them as tools, inside Claude with nothing to install and inside Claude Code, Cursor and other MCP clients through a local package. Each tool calls the same endpoints with your key. How to connect each client, and every tool with its plan, are in the MCP tool reference.
Free lookup
One browser lookup needs no key: CAGE code lookup resolves a five-character CAGE to the firm that holds it, one record at a time. The same question for many records at once is the SAM Entity Registry above.
Choose a plan
Get a free key to try the API, then subscribe to the plan that includes what you need; prices and limits are on Pricing. Read the quickstart to make your first call.