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).

Parameters

Name	Type	Required	Default	Description
companyDomain	string	❌ No	-	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	❌ No	-	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	❌ No	all	Filter by contract status: "active" (currently in effect), "churned" (expired/ended), or "all" (default, both).
vendorName	string	❌ No	-	Case-insensitive partial match on the counterparty vendor/GSI name, e.g. "Accenture" or "IBM". Omit to return all vendors.
minDealValue	number	❌ No	-	Only return contracts whose total deal value is at least this many USD, e.g. 1000000 for $1M+.
maxDealValue	number	❌ No	-	Only return contracts whose total deal value is at most this many USD.
endDateBefore	string	❌ No	-	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	❌ No	-	Only return contracts ending on or after this date (ISO "YYYY-MM-DD", e.g. "2025-01-01").
limit	number	❌ No	50	Maximum number of contracts to return, sorted by deal value descending (default 50, capped at 100).
includeFederalContracts	boolean	❌ No	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

• 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
  }
}

Related Tools

company_firmographic, company_technographic, company_spend, search_federal_contracts, company_gov_relationships