Beam background
Company & Employee Enrichment API

Retrieve Your Lists and Their Details with our Enrichment API

Fetch your lists
Free

This endpoint allows you to retrieve the lists that belong to your team.

Query

page Optional
The page to fetch (default: 1). …/lists?page=1
size Optional
The number of lists to be returned (between 1 and 100). Default to 10. …/lists?size=50
type Optional
The type of lists to retrieve. …/lists?type=companies
Possible values companies employees

Response

lists array
The lists that belong to your team.
Show attributes
meta array
The metas information.
Show attributes
endpoint
GET https://api.thecompaniesapi.com/v1/lists
Response
Copy
{ data : [ { analytics : { }, companyList : null , createdAt : "2022-04-01T13:07:14.000+00:00" , dynamic : false , id : 4246 , imported : false , integrations : [ ], invisible : false , name : "French NodeJS Companies" , processActive : false , processInitialized : true , processingAt : "2022-04-01T13:07:15.000+00:00" , query : [ ], type : "companies" , } , { analytics : { }, companyList : { }, createdAt : "2022-02-22T07:23:53.000+00:00" , dynamic : false , id : 3838 , imported : false , integrations : [ ], invisible : false , name : "Edtech Ceos & Founders" , processActive : false , processInitialized : true , processingAt : "2022-02-22T07:23:53.000+00:00" , query : [ ], type : "employees" , } , { analytics : { }, companyList : null , createdAt : "2022-02-22T07:23:52.000+00:00" , dynamic : false , id : 3837 , imported : false , integrations : [ ] , invisible : false , name : "Edtech Companies" , processActive : false , processInitialized : true , processingAt : "2022-02-22T07:23:53.000+00:00" , query : [ ], type : "companies" , } , ] , meta : { currentPage : 1 , firstPage : 1 , lastPage : 1 , perPage : 10 , total : 4 , } , }

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

Companies
Employees
Industries
Job titles
Locations
Lists