Company Contracts

Retrieve a company's known contract intelligence — vendor relationships, deal values, contract status/durations, service-line breakdowns, renewal timing, and contractHolder (the entity holding each contract). Trigger on questions like "who does <company> have contracts with?", "what are <company>'s outsourcing deals and their values?", or "when are <company>'s contracts up for renewal?". Provide a company domain (e.g. "salesforce.com") OR an HG Insights company ID (hg_id); if both are given, hg_id wins. Domain lookups roll up contracts held by subsidiaries across the corporate family (matching the HG app); hg_id lookups return that one entity only.

SCOPE: returns ICT outsourced contracts — typically large managed-services/IT-outsourcing deals brokered by Global System Integrators like Accenture, IBM, or Cognizant, sourced from publicly announced deals (not comprehensive). It is NOT individual product contracts (e.g. a VMware ELA or NetApp agreement), reseller relationships, or vendor renewal/expiration dates.

Use this when you want a company's outsourcing/GSI contract footprint and renewal opportunities; pair it with company_firmographic, company_technographic, and company_spend for full account context. Do NOT use this to browse U.S. federal award records across many recipients — use search_federal_contracts (keyword/agency/NAICS search) instead; company_gov_opportunities and company_gov_relationships cover a company's government pipeline and agency ties. To fold this one company's federal awards INTO these results, set includeFederalContracts=true (requires the datagov / SAM.gov integration): the response adds USAspending.gov awards (awarding agency, contract type, NAICS/PSC codes, set-aside type) plus SAM.gov entity registration (UEI, CAGE code, business types).

Credits

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

Parameters

Name	Type	Default	Description
companyDomain	string	-	Company domain to look up contracts for, e.g. "salesforce.com". Provide either companyDomain or hg_id. Domain lookups roll up subsidiary contracts across the corporate family. Protocol prefixes (http://, https://), a leading "www.", and trailing paths/queries/fragments are stripped automatically and case is normalized, so a full URL is accepted.
hg_id	string	-	HG Insights company ID (32 hex/alphanumeric characters), typically taken from a prior search_companies or company_firmographic result. When provided it overrides companyDomain and returns contracts for that exact entity only (no subsidiary roll-up).
status	string	all	Filter by contract status: "active" (currently in effect), "churned" (expired/ended), or "all" (default, both).
vendorName	string	-	Case-insensitive partial match on the counterparty vendor/GSI name, e.g. "Accenture" or "IBM". Omit to return all vendors.
minDealValue	number	-	Only return contracts whose total deal value is at least this many USD, e.g. 1000000 for $1M+.
maxDealValue	number	-	Only return contracts whose total deal value is at most this many USD.
endDateBefore	string	-	Only return contracts ending on or before this date (ISO "YYYY-MM-DD", e.g. "2025-12-31"). Useful for finding near-term renewal opportunities.
endDateAfter	string	-	Only return contracts ending on or after this date (ISO "YYYY-MM-DD", e.g. "2025-01-01").
limit	number	50	Maximum number of contracts to return, sorted by deal value descending (default 50, capped at 100).
includeFederalContracts	boolean	false	When true, also fetch this company's U.S. federal government awards from USAspending.gov and merge them into the contracts list (each tagged source="usaspending"). Requires the datagov integration (a SAM.gov API key) to be configured; the call fails with a setup message if it is not. The response then adds SAM.gov entity registration (UEI, CAGE code, business types) and federalDataStatus metadata. Defaults to false (HG contracts only).

Required Integrations

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

• HG Insights (v2) (hginsights_v2)

Use Cases

• Which vendors and GSIs (Accenture, IBM, Cognizant) does a company have outsourcing contracts with?
• What are a company's largest contracts by deal value? — sort/filter with minDealValue
• Which contracts are expiring soon so I can time a renewal play? — endDateBefore + status:active
• Show only Accenture-related deals for this account — vendorName filter
• What federal awards does this contractor hold? — includeFederalContracts:true (adds USAspending + SAM.gov data)

Example Usage

All contracts for a company (with subsidiary roll-up)

{
  "tool": "company_contracts",
  "arguments": {
    "companyDomain": "cisco.com"
  }
}

Active contracts expiring in 2025

{
  "tool": "company_contracts",
  "arguments": {
    "companyDomain": "salesforce.com",
    "status": "active",
    "endDateBefore": "2025-12-31"
  }
}

Include U.S. federal awards from USAspending.gov

{
  "tool": "company_contracts",
  "arguments": {
    "companyDomain": "palantir.com",
    "includeFederalContracts": true
  }
}

Response Format

Field	Type	Description
companyDomain	string	The company domain that was queried
organizationId	string	The HG Insights organization identifier
companyName	string	The company name
contractCount	number	Number of contracts returned
totalContractValue	string	Total contract value formatted as currency
totalContractValueAmount	number	Total contract value as numeric amount
contracts	array	List of contracts (HG and optionally federal)
contracts[].contractId	string
contracts[].vendorName	string
contracts[].vendorDomain	string
contracts[].productName	string
contracts[].productCategory	string
contracts[].headline	string
contracts[].status	string
contracts[].dealValue	string	Deal value formatted as currency
contracts[].dealValueAmount	number
contracts[].annualValue	string
contracts[].annualValueAmount	number
contracts[].startDate	string
contracts[].endDate	string
contracts[].contractTermMonths	number
contracts[].renewalLikelihood	number	0-100 score
contracts[].daysUntilRenewal	number
contracts[].churnRiskScore	number	0-100 score
contracts[].contractHolder	string	Name of the entity holding the contract (populated for subsidiary contracts)
contracts[].country	string
contracts[].source	string	Data source (present when includeFederalContracts=true)
contracts[].federalData	object	Federal contract details (only when source='usaspending')
contracts[].federalData.awardId	string
contracts[].federalData.awardingAgency	string
contracts[].federalData.awardingSubAgency	string
contracts[].federalData.fundingAgency	string
contracts[].federalData.contractType	string
contracts[].federalData.setAsideType	string
contracts[].federalData.naicsCode	string
contracts[].federalData.naicsDescription	string
contracts[].federalData.pscCode	string
contracts[].federalData.pscDescription	string
contracts[].federalData.placeOfPerformance	object
contracts[].federalData.placeOfPerformance.city	string
contracts[].federalData.placeOfPerformance.state	string
contracts[].federalData.placeOfPerformance.country	string
hasMore	boolean	Whether there are more contracts available
samEntity	object	SAM.gov entity registration data (present when includeFederalContracts=true and entity is resolved)
samEntity.uei	string	Unique Entity Identifier
samEntity.cageCode	string	Commercial and Government Entity code
samEntity.legalBusinessName	string
samEntity.registrationStatus	string
samEntity.businessTypes	array	e.g., Large Business, 8(a), HUBZone
samEntity.naicsCodes	array
samEntity.pscCodes	array
samEntity.samRegistrationDate	string
samEntity.samExpirationDate	string
federalDataStatus	object	Metadata about the federal data fetch (present when includeFederalContracts=true)
federalDataStatus.resolved	boolean	Whether the federal data fetch completed
federalDataStatus.samEntityFound	boolean	Whether a SAM.gov entity was found
federalDataStatus.contractsFound	number	Number of federal contracts found
federalDataStatus.dataAsOf	string	Date of data freshness
federalDataStatus.errors	array	Any errors during federal data fetch

Related Tools

company_firmographic, company_technographic, company_spend, search_federal_contracts, company_gov_relationships