Beam background
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

page Optional
The page to fetch (default to 1). …/lists/:listId/employees?page=1
size Optional
The number of employees to be returned (between 1 and 100). Default to 10. …/lists/:listId/employees?size=50
sortField Optional
The field to sort the results. …/employees?sortField=fullName
Possible values createdAt fullName gender jobTitle locationCity locationContinent locationCountry locationCounty locationState
sortOrder Optional
The order to sort the results. …/employees?sortOrder=asc
Possible values asc desc

Response

employees array
The employees that belong to your list.
Show attributes
meta array
The metas information.
Show attributes
endpoint
GET https://api.thecompaniesapi.com/v1/lists/1234/employees
Response
Loading response...

Discover our other features to enrich your companies and identify employees in real-time

Companies
Employees
Industries
Job titles
Locations
Lists