Find federal contractors with proven past performance for a NAICS, agency, state, or set-aside, ranked by dollars won, with named points of contact. JSON, one GET.
Finding a teaming partner or a subcontractor for a federal bid means answering one question: who has actually done this kind of work? Registration directories (SBA DSBS, SAM entity search) tell you who is registered in a NAICS, including firms that have never won a dollar. They do not tell you who has real past performance, for which agency, at what scale, or who to call. This endpoint does. Pass a NAICS, agency, state, or set-aside, get back the firms that have won matching prime contracts, ranked by gross obligated dollars, each with its socioeconomic status, SAM registration, and named points of contact.
Who this is for: primes assembling a bid team, small firms looking for primes to sub under, BD teams researching counterparties, and developers building teaming, capture, or supplier-discovery tools.
What this is NOT: a subaward relationship graph. We surface prime past performance plus contacts; we do not claim to show existing prime-to-sub teaming arrangements. For who registered but never won, use Federal Contractor Search instead.
At least one filter is required, the endpoint will not dump the whole corpus. Filters combine (AND).
naics=<code>: NAICS code, exact, 2 to 6 digits (e.g. 541512).agency=<name>: awarding agency name or acronym, resolved through the agency crosswalk (e.g. Army, Navy, Air Force, USACE). This is the only contractor endpoint that filters by agency.state=<XX>: 2-letter place-of-performance state (e.g. TX).set_aside=<flag>: one of sdvosb, vosb, wosb, woman_owned, hubzone, 8a, sdb, minority_owned.psc=<code>: Product or Service Code, exact.keywords=<text>: matches the prime-award description text.Results are ranked by gross obligated dollars (most recent award breaks ties). Pagination via limit (1-50, default 20) and offset (0-200). The response includes pagination.total, the exact distinct-firm count for your filters.
Real queries, real results (curl-pasted from production).
curl -H "Authorization: Bearer YOUR_KEY" \
"https://govconapi.com/api/v1/partners/search?set_aside=sdvosb&state=VA&naics=541512&limit=1"{
"data": [
{
"uei": "GLGMWJ8EVMR9",
"name": "LIBERTY IT SOLUTIONS LLC",
"contracts": 5,
"gross_obligated": 228028115.0,
"last_award_date": "2025-03-20",
"set_asides": ["sdvosb", "vosb", "sdb"],
"agencies": ["Department of Veterans Affairs"],
"registration_status": "A",
"location": "MC LEAN, VA",
"primary_naics": "541512",
"pocs": [
{"name": "Bryan Jones", "title": null, "city": "Mclean", "state": "VA", "roles": ["govt_business_primary"]},
{"name": "Caitlin Kowalski", "title": null, "city": "Mclean", "state": "VA", "roles": ["govt_business_alt"]}
]
}
],
"pagination": {"limit": 1, "offset": 0, "total": 135, "total_is_estimate": false, "has_next": true},
"filters_applied": {"naics": "541512", "state": "VA", "set_aside": "sdvosb"},
"_sources": ["usaspending_fpds", "sam_entities"]
}curl -H "Authorization: Bearer YOUR_KEY" \
"https://govconapi.com/api/v1/partners/search?naics=237990&agency=Army&state=TX"The agency=Army filter is what makes this query possible: a registry search cannot tell you who has won Army work specifically.
One object per firm in data[], ranked by gross_obligated descending:
uei, name: SAM unique entity ID and legal business name.contracts: distinct prime contract awards matching your filters.gross_obligated: sum of positive federal obligations on those awards (USD).last_award_date: most recent matching award action date.set_asides: socioeconomic categories the firm has actually won under.agencies: awarding sub-agencies on the matching awards (up to 5).registration_status, location, primary_naics: from SAM.pocs[]: named SAM points of contact, each with name, title, city, state, and roles[]. No email or phone, SAM registration POCs do not carry them.pagination carries total (exact distinct-firm count), total_is_estimate (always false), and has_next. Every response also carries _sources.
| You want to | Use | Backed by |
|---|---|---|
| Find firms with proven past performance for a NAICS, agency, state, or set-aside, ranked, with who to call | this (/partners/search) |
FPDS awards + SAM contacts |
| Find firms registered for work by NAICS, state, or certification (including firms that have won nothing) | Federal Contractor Search | SAM registry |
| Vet or profile one firm you already have, by UEI | Company Intelligence | SAM + FPDS |
Short version: registry and capability go to Federal Contractor Search; proven performance with contacts comes from here; vetting a known firm goes to Company Intelligence. This is the only one of the three that filters by awarding agency, ranks by dollars won, and returns points of contact.
/api/v1/companies/{uei} (Pro): take any uei from a result and pull the firm's full award history, top agencies, NAICS spread, and subaward revenue./api/v1/entities/search (Pro): widen to the full registry when you also want firms that are registered but have not yet won./api/v1/exclusions/search?uei={uei} (Developer): debarment check a candidate before you reach out./api/v1/vendor-risk/bulk (Pro): screen up to 100 UEIs from your shortlist in one call.agency=Army resolves to the awarding agencies under the Department of the Army. Pass the common name or acronym; obscure sub-office strings may not resolve.
The partner finder is on the Pro plan ($39/mo).
No annual contracts, no setup fees, monthly billing via Stripe. Cancel anytime.
Does this show who actually subcontracts to whom?
No. It ranks firms by the prime contract work they have won for your filters and gives you their points of contact. It does not map subaward (FFATA) teaming relationships; that data is thin (FY2025 onward) and is not in this endpoint. Use it to find capable firms and reach them, then qualify the relationship yourself.
Do the points of contact include email and phone?
No. SAM registration points of contact carry name, role, and city/state, not email or phone. You get who to look for at each firm, not a direct dial.
How are results ranked?
By gross obligated dollars on the matching prime contract awards, most recent award breaking ties. It is a factual sort, not a winnability score.
How far back does the past-performance data go?
Prime contract performance is FPDS data from FY2025 (October 1, 2024) onward, refreshed daily. Firm profiles and contacts come from the current SAM registry.
How is this different from a contractor registry search?
A registry search returns firms that are registered, including firms that have never won anything, with no dollars, agency, or contacts. This returns only firms with real past performance for your filters, ranked by what they won, with named contacts, and it is the only one that filters by awarding agency.