harmonic_get_company_employees
Retrieve company employee data with filtering by role and status to identify founders, executives, or former employees for due diligence.
Instructions
Get employees of a company with filtering options.
Input:
company_id: Numeric ID or URN
employee_group_type: Filter by role (ALL, FOUNDERS_AND_CEO, EXECUTIVES, FOUNDERS, LEADERSHIP, NON_LEADERSHIP, ADVISORS, NON_PARTNERS)
employee_status: Filter by status (ACTIVE, NOT_ACTIVE, ACTIVE_AND_NOT_ACTIVE)
Note: Filter values confirmed via API testing. Documentation had incorrect values (EMPLOYEES, CURRENT, PAST do not work).
Returns: Person URNs that you can use with harmonic_get_person to get full details.
Example Response (JSON): { "data": [ { "urn": "urn:harmonic:person:113554", "id": "113554" }, { "urn": "urn:harmonic:person:155348322", "id": "155348322" } ], "count": 72, "hasMore": false }
Common workflows:
Get founders: employee_group_type="FOUNDERS_AND_CEO"
Get leadership: employee_group_type="LEADERSHIP"
Get former employees: employee_status="NOT_ACTIVE"
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| company_id | Yes | Company ID or URN | |
| size | No | Number of employees to return (default: 10, max: 100) | |
| page | No | Page number for pagination (0-indexed) | |
| employee_group_type | No | Filter by employee type: ALL, FOUNDERS_AND_CEO, EXECUTIVES, FOUNDERS, LEADERSHIP, NON_LEADERSHIP, ADVISORS | |
| employee_status | No | Filter by status: ACTIVE, ACTIVE_AND_NOT_ACTIVE, NOT_ACTIVE | |
| response_format | No | Output format: "json" or "markdown" | json |