Beam background
Company & Employee Enrichment API

Create a List of Companies or Employees with our Enrichment API

Create a list of companies or employees
Free

This endpoint allows you to create a list of companies or employees.

Query parameters

dynamicoptional
Whether the list is dynamic or not. If set to true, the list will be updated automatically when new companies or employees are added to the database.
Possible values
false
true
namerequired
The name of the list.
typerequired
The type of list to create.
Possible values
companies
employees

Response

list. analyticsobject
The analytics of the list.
list. companyListobject
The associated company list when there is one.
list. createdAtdate
When the list was created.
2022-02-22T07:23:52.000+00:00
list. dynamicboolean
Whether the list is dynamic or static.
true
list. idnumber
The id of the list.
3838
list. importedboolean
Whether the list has been imported.
true
list. integrationsarray
The integrations associated with the list.
list. invisibleboolean
Whether the list is invisible (for internal use).
true
list. namestring
The name of the list
French NodeJS Companies
list. processActiveboolean
The process active status of the list (for internal use).
true
list. processInitializedboolean
The process initialized flag (for internal use).
true
list. processingAtdate
When the list is being processed.
2022-02-22T07:23:52.000+00:00
list. queryarray
The query used to generate the list.
list. typestring
The type of the list.
companies
Possible values
companies
employees
POST
https://api.thecompaniesapi.com/v1/lists
{
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" ,}
Company & Employee Enrichment API

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

Companies
Employees
Industries
Job titles
Locations
Lists