Company Contracts

Retrieve contract intelligence for a company including ICT outsourced contracts via Global System Integrators (GSIs).

Important: Data Scope & Limitations

Contract Data focuses on ICT outsourced contracts (typically via Global System Integrators) associated with entities in the HG Insights Platform. Understanding this scope is critical for effective use.

What Contract Data Includes

• ICT outsourced contracts - Managed services, IT outsourcing, cloud migration, digital transformation engagements
• Global System Integrator (GSI) relationships - Contracts with major GSIs like Accenture, IBM, Cognizant, Infosys, TCS, Wipro, etc.
• Contract details - Signing location, duration, scope, total contract value (TCV)
• Service line categorization - Each contract is reviewed and categorized by service line with attributed spend
• GSI comparisons - Active customers, geographic penetration, TCV by service line

What Contract Data Does NOT Include

Not Included	Example
Individual product contracts	NetApp storage agreements, VMware Enterprise License Agreements
Lower-level reseller relationships	Though large resellers like CDW, WWT may appear
Comprehensive market view	Many contracts are never publicly announced
Product/vendor renewal dates	Use technographic first_verified_date as a proxy (typically 2-3 months after tech introduction)

Data Sources

The majority of contracts come from publicly available sources. HG's differentiation comes from:

1. Human review - Each contract is reviewed by analysts
2. Service line attribution - Spend is attributed to specific service lines
3. Combined analysis - Power comes from combining with Firmographic, IT Spend, and IT Install data

Parameters

Name	Type	Required	Default	Description
companyDomain	string	Yes	-	The company domain to look up contracts for (e.g., "salesforce.com")
hg_id	string	No	-	HG Insights company ID (32 alphanumeric characters). When provided, overrides companyDomain.
status	string	No	all	Filter by contract status: "active", "churned", or "all"
vendorName	string	No	-	Filter contracts by vendor name (partial match)
minDealValue	number	No	-	Minimum deal value filter in USD
maxDealValue	number	No	-	Maximum deal value filter in USD
endDateBefore	string	No	-	Filter contracts ending before this date (ISO format)
endDateAfter	string	No	-	Filter contracts ending after this date (ISO format)
limit	number	No	50	Maximum contracts to return (max: 100)
includeFederalContracts	boolean	No	false	When true, enriches results with U.S. federal government contract data from USAspending.gov. Requires the datagov integration in addition to hginsights_v2.

Required Integrations

• hginsights_v2

Best Practices

Combine with Other Data for Maximum Value

Contract Data is most powerful when used alongside other HG Insights data:

With Firmographic Data

• Understand which verticals and organization sizes a GSI engages
• Segment GSI customers by geography and industry

With IT Spend Data

• Identify what spend the GSI has strategic influence over
• Understand budget implications of GSI relationships

With IT Install/Technographic Data

• See which technology vendors the GSI works with
• Track technology transformations from contract start to end
• Identify displacement opportunities

Sales Play Examples

Attacking Existing Contracts

1. Isolate contracts about to expire using endDateBefore filter
2. Use company_technographic to understand current tech stack
3. Use company_spend to build "challenger" statements on cost/agility

Supporting Incumbent Vendors

1. Find active contracts with target GSIs using vendorName filter
2. Combine with company_fai for departmental insights
3. Identify expansion opportunities within existing relationships

GSI Heat-Mapping

1. Search for contracts with specific GSI
2. Enrich with company_firmographic for vertical analysis
3. Combine with company_spend for spending pattern insights

Product Renewal Proxy (Workaround)

Since Contract Data doesn't include product-level renewal dates, clients build proxies:

1. Compare your install base with HG's technographic data
2. Use first_verified_date from technographic - typically 2-3 months after tech introduction
3. Knowing usual agreement lengths (1, 3 years), prioritize accounts maturing in next 6-9 months

Example Usage

MCP Client

{
  "tool": "company_contracts",
  "parameters": {
    "companyDomain": "salesforce.com",
    "status": "active",
    "vendorName": "Accenture"
  }
}

Finding Expiring Contracts

{
  "tool": "company_contracts",
  "parameters": {
    "companyDomain": "target-company.com",
    "endDateBefore": "2025-12-31",
    "status": "active"
  }
}

Claude Desktop

Use the company_contracts tool to find contract intelligence for a company.
Note: This returns ICT outsourced contracts with GSIs, not individual product contracts.

Response Format

The tool returns a structured JSON response with:

{
  "data": {
    "companyDomain": "salesforce.com",
    "organizationId": "123456",
    "companyName": "Salesforce",
    "contractCount": 5,
    "totalContractValue": "$150,000,000",
    "totalContractValueAmount": 150000000,
    "contracts": [
      {
        "contractId": "abc123",
        "vendorName": "Accenture",
        "headline": "Digital transformation engagement",
        "status": "Active",
        "dealValue": "$50,000,000",
        "dealValueAmount": 50000000,
        "startDate": "2023-01-01",
        "endDate": "2026-01-01",
        "contractTermMonths": 36,
        "country": "United States"
      }
    ],
    "hasMore": false
  },
  "metadata": {
    "executionTimeMs": 450,
    "timestamp": "2025-02-05T12:00:00Z"
  }
}

Error Handling

Common errors:

• Company Not Found: Domain not found in HG Insights database
• Missing Integration: HG Insights v2 API key not configured
• Rate Limit: API rate limit exceeded
• Authentication Error: Invalid API key

Related Tools

For comprehensive company analysis, combine with:

• company_firmographic - Company size, industry, location
• company_technographic - Technology stack and usage
• company_spend - IT spending patterns
• company_fai - Functional Area Intelligence by department
• company_intent - Buying signals and intent data

Next Steps

• View all tools
• See example workflows
• Read best practices