Company Gov Relationships

company_gov_relationships — map a company's federal teaming partners / prime-sub network / subcontractor relationships from USAspending.gov subaward records. Given a company domain, resolves to its SAM.gov entity (UEI, CAGE), then aggregates two directions: as a subcontractor (which primes pass work down to it) and as a prime (which subcontractors it passes work to). Each partner rollup includes contract count, total subaward value, and the largest recent award. Trigger on: "who does <company> team with on federal contracts?", "which primes subcontract to <company>?", "who are <company>'s subcontractors on government work?". Do NOT use to find OPEN solicitations a company should bid on — use company_gov_opportunities (one company's bid pipeline) or search_gov_opportunities (broad SAM.gov RFP/RFQ search). Do NOT use for a company's commercial ICT/outsourcing (GSI) contracts — use company_contracts. Only covers subaward (prime↔sub) relationships, not top-level prime award totals. Requires the SAM.gov (Data.gov) integration to be configured.

Credits

1 — Per call. See the full credit table for how AI Credits work.

Parameters

Name	Type	Default	Description
company_domain Required	string	-	The company domain to look up (e.g., "palantir.com"). Protocol prefixes (http://, https://), leading www., and trailing paths/queries/fragments are accepted and stripped automatically; case is normalized.
relationshipType	string	both	Which teaming direction to return: "prime" = the company's own subcontractors (company acts as prime); "sub" = the primes that subcontract to the company (company acts as sub); "both" (default) returns both directions.
minAmount	number	-	Only include subawards worth at least this many USD, e.g. 100000 for $100K+. Applied per subaward before partner rollups are computed. Omit to include all.
fiscalYearStart	number	-	Earliest federal fiscal year to search, as a 4-digit year, e.g. 2020. Defaults to the current year minus 5. Data is aggregated from this year to the present.
limit	integer	50	Maximum number of distinct partner companies returned per direction, ranked by total subaward value descending (1-100, default 50).

Required Integrations

This tool is only available when your organization has the following integration configured in the HG Insights Integrations settings:

• SAM.gov (Data.gov) (datagov)

Use Cases

• Who does a company team with on federal contracts, and in which direction (prime vs. sub)?
• Which prime contractors subcontract work to this company? — relationshipType:'sub'
• Which subcontractors does this company pass work down to as a prime? — relationshipType:'prime'
• Which of a company's federal partners represent the largest subaward dollars? — ranked by total value
• Filter a teaming network to only material relationships — minAmount to drop small subawards

Example Usage

Full teaming network for a company

{
  "tool": "company_gov_relationships",
  "arguments": {
    "company_domain": "boozallen.com"
  }
}

Primes that subcontract to a company, $100K+ only

{
  "tool": "company_gov_relationships",
  "arguments": {
    "company_domain": "palantir.com",
    "relationshipType": "sub",
    "minAmount": 100000
  }
}

A company's own subcontractors since FY2020

{
  "tool": "company_gov_relationships",
  "arguments": {
    "company_domain": "boozallen.com",
    "relationshipType": "prime",
    "fiscalYearStart": 2020
  }
}

Response Format

Field	Type	Description
companyName	string	Resolved company name from SAM.gov
companyDomain	string	The company domain that was looked up
samEntity	object	SAM.gov entity registration details
samEntity.uei	string
samEntity.cageCode	string
samEntity.legalBusinessName	string
asSubcontractor	object	Relationships where this company acts as a subcontractor
asSubcontractor.totalValue	number
asSubcontractor.totalValueFormatted	string
asSubcontractor.primeContractors	array
asSubcontractor.primeContractors[].partnerName	string
asSubcontractor.primeContractors[].contractCount	number
asSubcontractor.primeContractors[].totalValue	number
asSubcontractor.primeContractors[].totalValueFormatted	string
asSubcontractor.primeContractors[].agencies	array
asPrimeContractor	object	Relationships where this company acts as the prime contractor
asPrimeContractor.totalValue	number
asPrimeContractor.totalValueFormatted	string
asPrimeContractor.subcontractors	array
asPrimeContractor.subcontractors[].partnerName	string
asPrimeContractor.subcontractors[].contractCount	number
asPrimeContractor.subcontractors[].totalValue	number
asPrimeContractor.subcontractors[].totalValueFormatted	string
asPrimeContractor.subcontractors[].agencies	array

Related Tools

company_gov_opportunities, search_gov_opportunities, company_contracts, search_federal_contracts