Find teaming partners

Find federal contractors with proven past performance for a NAICS, awarding agency, place-of-performance state, or set-aside, ranked by gross obligated dollars, each with its socioeconomic status, SAM registration, and named points of contact. Composed from FPDS prime awards (FY2025 onward) plus the SAM registry. Built for teaming and subcontractor sourcing. Factual, not scored.

Every recommended firm is screened against the active federal exclusion (debarment) list, so a currently-excluded contractor is flagged rather than returned as a clean recommendation. The check counts only exclusions in force today: a debarment that has been terminated or lifted does not flag.

Parameters

At least one filter is required; the endpoint will not return the whole corpus. Unknown parameters return 400.

Parameter	Description
naics	NAICS code, exact, 2 to 6 digits.
agency	Awarding agency name or acronym, resolved through the agency crosswalk (Army, Navy, Air Force). The only contractor endpoint that filters by agency.
state	2-letter place-of-performance state.
set_aside	One of sdvosb, vosb, wosb, woman_owned, hubzone, 8a, sdb, minority_owned.
psc	Product or Service Code, exact.
keywords	Matches the prime-award description text.
limit	1 to 50, default 20.
offset	0 to 200 (top ~250 firms per query; narrow filters for more).

Response

Standard list envelope: data, pagination, filters_applied, and _sources (["usaspending_fpds", "sam_entities"]). Results are ranked by gross_obligated descending, most recent award breaking ties. Each row carries uei, name, contracts, gross_obligated, last_award_date, set_asides, agencies, registration_status, location, primary_naics, pocs[], plus the resolved contact / contact_status and entity_url (the company's own SAM-registered website, null when SAM has none on file , same resolver as Resolve a vendor's contact).

Each row also carries excluded (boolean): false when the firm is clear of the active federal exclusion list, true when it is currently debarred. When true, an exclusions[] block is present, each entry carrying exclusion_type, excluding_agency, activate_date, classification, and is_fascsa. The excluded field is omitted from a row only if the screen itself could not run, so excluded: false always means screened-and-clear, never merely unknown.

Rate limits

Tighter than general search because it surfaces contact data: 15 requests/minute per IP, 20/minute per key, pages capped at 50, pagination depth capped at 200. Bulk extraction is not supported by design.

Example

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://govconapi.com/api/v1/partners/search?set_aside=sdvosb&state=VA&naics=541512&limit=1"

Returns 135 SDVOSB IT firms in Virginia ranked by dollars won; the top result is Liberty IT Solutions ($228M, 5 contracts) with its Department of Veterans Affairs award record and named points of contact. See the Teaming Partner Finder guide for worked examples.