# Company Enrichment

The enrichment endpoint returns firmographics, spend, and technographics data for companies.

## Endpoint


```
POST /api/v2/companies/enrich
```

## Request


```json
{
  "companies": {
    "ids": ["1698C53EBC888758570396E0334965C1"]
  },
  "fields": ["firmographics", "spend", "technographics"]
}
```

### Parameters

| Parameter | Type | Required | Description |
|  --- | --- | --- | --- |
| `companies.ids` | array | Yes | Company IDs (hex format, max 50) |
| `fields` | array | No | Data categories to return |


### Field Groups

You can request specific data categories by including them in the `fields` array:

- **`firmographics`** - Company information including name, domain, location, industry classification, revenue, employee counts, and HG rankings
- **`spend`** - IT spending data organized by technology category, including spend amounts and category details
- **`technographics`** - Technology installation data including products, vendors, usage intensity, installation dates, and product categories


If you omit the `fields` parameter, all available field groups will be returned in the response.

## Response


```json
{
  "companies": [
    {
      "company_id": "1698C53EBC888758570396E0334965C1",
      "firmographics": {
        "name": "Walmart Inc.",
        "url": "walmart.com",
        "country_code": "US",
        "employees_total": 2100000,
        "revenue_total": 680985000000
      },
      "spend": {
        "all": [...],
        "all_count": 135
      },
      "technographics": {
        "installs": [...],
        "installs_count": 5900
      }
    }
  ]
}
```

## Filtering Technographics

Filter installs by vendor, product, or category:


```json
{
  "companies": {"ids": ["..."]},
  "fields": ["technographics"],
  "filters": {
    "technographics": {
      "vendors": {"ids": [316]},
      "products": {"ids": [814]}
    }
  }
}
```