API to Fetch Employees in Your Lists

Company & Employee Enrichment API

Retrieve Employees from Your Lists with our Enrichment API

Fetch employees in your list
Free

This endpoint allows you to fetch the employees in your lists.

Query parameters

pageoptional

The page to fetch (default to 1).

…/lists/:listId/employees?page=1

sizeoptional

The number of employees to be returned (between 1 and 100). Default to 10.

…/lists/:listId/employees?size=50

sortFieldoptional

The field to sort the results.

…/employees?sortField=fullName

Possible values

createdAt

fullName

gender

jobTitle

locationCity

locationContinent

locationCountry

locationCounty

locationState

sortOrderoptional

The order to sort the results.

…/employees?sortOrder=asc

Possible values

asc

desc

Response

employeesarray

The employees that belong to your list.

metaobject

The metas information.

endpoint

GET

https://api.thecompaniesapi.com/v1/lists/1234/employees

API response

The response is empty

We did not receive any data from the API. Contact us if you think this is an error.

Company & Employee Enrichment API

Supercharge your product or your sales machine with our enrichment API for companies and employees

CompaniesSearch or enrich companies

7 Endpoints

EmployeesIdentify or enrich employees

3 Endpoints

IndustriesBrowse our industries

2 Endpoints

Job titlesBrowse our job titles

1 Endpoint

LocationsBrowse our locations

5 Endpoints

ListsManage your lists

4 Endpoints

Retrieve Employees from Your Lists with our Enrichment API

Fetch employees in your listFree

Query parameters

Response

Supercharge your product or your sales machine with our enrichment API for companies and employees

Fetch employees in your list
Free