# hunter.people.enrich.combined

Person and company profile from an email or LinkedIn handle

> Returns all the information associated with an email address and its domain name.

Page: https://telipot.com/catalog/tasks/hunter.people.enrich.combined · Markdown: https://telipot.com/catalog/tasks/hunter.people.enrich.combined/md · JSON: https://telipot.com/catalog/tasks/hunter.people.enrich.combined/json

| Field | Value |
| --- | --- |
| provider | [Hunter](https://telipot.com/catalog/providers/hunter) `hunter` |
| capability | [`people.enrich.combined`](https://telipot.com/catalog/capabilities/people.enrich.combined) |
| kind | data |
| tier | core |
| price | Price unknown (Not listed, not free) |
| price note | The credit article prices enrichment at 0.2 credit per enriched email or domain on All-in-one plans and names no rate for the combined route, which returns a person and a company. |
| identity | Your plan |
| auth | `api_key · in header as X-API-KEY` |
| scope | any_account |
| principal | organization |
| required_scopes | none |
| retention | standard |
| route | `GET https://api.hunter.io/v2/combined/find` |
| verification | Untestable. Needs a specific person's email address or LinkedIn handle and answers with that person's profile beside the employer's. |
| status | live |
| docs | https://hunter.io/api-documentation/v2#combined-enrichment |

## Inspect first

No complete example input is recorded. Read the schema and field notes before building the call.

```bash
telipot inspect hunter.people.enrich.combined
```

```bash
curl https://api.telipot.com/v1/tasks/hunter.people.enrich.combined \
  -H "Authorization: Bearer $TELIPOT_TOKEN"
```

## Input

| Field | In | Type | Required | Constraints | Note |
| --- | --- | --- | --- | --- | --- |
| `email` | queryParams | string | no |  | Email address to enrich. The docs page names only email; Hunter's OpenAPI also accepts linkedin_handle. Give one of them. |
| `linkedin_handle` | queryParams | string | no |  | LinkedIn profile handle to enrich. Listed in Hunter's OpenAPI, not on the docs page. |

## Input schema

```json
{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "description": "Email address to enrich. The docs page names only email; Hunter's OpenAPI also accepts linkedin_handle. Give one of them."
    },
    "linkedin_handle": {
      "type": "string",
      "description": "LinkedIn profile handle to enrich. Listed in Hunter's OpenAPI, not on the docs page."
    }
  },
  "additionalProperties": false
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "data",
    "meta"
  ],
  "properties": {
    "data": {
      "type": "object",
      "required": [
        "person",
        "company"
      ],
      "properties": {
        "person": {
          "type": "object",
          "properties": {
            "id": {
              "type": "string"
            },
            "name": {
              "type": "object",
              "properties": {
                "fullName": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "givenName": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "familyName": {
                  "type": [
                    "string",
                    "null"
                  ]
                }
              }
            },
            "email": {
              "type": "string"
            },
            "location": {
              "type": [
                "string",
                "null"
              ]
            },
            "bio": {
              "type": [
                "string",
                "null"
              ]
            },
            "avatar": {
              "type": [
                "string",
                "null"
              ]
            },
            "employment": {
              "type": "object",
              "properties": {
                "domain": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "name": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "title": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "role": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "seniority": {
                  "type": [
                    "string",
                    "null"
                  ]
                }
              }
            },
            "linkedin": {
              "type": "object",
              "properties": {
                "handle": {
                  "type": [
                    "string",
                    "null"
                  ]
                }
              }
            },
            "twitter": {
              "type": "object",
              "properties": {
                "handle": {
                  "type": [
                    "string",
                    "null"
                  ]
                }
              }
            },
            "phone": {
              "type": [
                "string",
                "null"
              ]
            }
          }
        },
        "company": {
          "type": "object",
          "properties": {
            "id": {
              "type": "string"
            },
            "name": {
              "type": [
                "string",
                "null"
              ]
            },
            "legalName": {
              "type": [
                "string",
                "null"
              ]
            },
            "domain": {
              "type": "string"
            },
            "description": {
              "type": [
                "string",
                "null"
              ]
            },
            "foundedYear": {
              "type": [
                "integer",
                "null"
              ]
            },
            "location": {
              "type": [
                "string",
                "null"
              ]
            },
            "category": {
              "type": "object",
              "properties": {
                "sector": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "industryGroup": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "industry": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "subIndustry": {
                  "type": [
                    "string",
                    "null"
                  ]
                }
              }
            },
            "metrics": {
              "type": "object",
              "properties": {
                "employees": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "employeesCount": {
                  "type": [
                    "integer",
                    "null"
                  ]
                },
                "annualRevenue": {
                  "type": [
                    "integer",
                    "null"
                  ]
                },
                "estimatedAnnualRevenue": {
                  "type": [
                    "integer",
                    "null"
                  ]
                }
              }
            },
            "tech": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "techCategories": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "fundingRounds": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "date": {
                    "type": "string"
                  },
                  "type": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "amount": {
                    "type": "string"
                  },
                  "investors": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "meta": {
      "type": "object",
      "properties": {
        "email": {
          "type": "string"
        }
      }
    }
  }
}
```