Retrieve your lists and their details with our API

Easily fetch and manage your saved lists with our API. Get all the details you need in one place.

Fetch your lists

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

Query parameters

pagenumber (optional)

The page to fetch (default: 1).

…/lists?page=1

sizenumber (optional)

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

…/lists?size=10

Response

listsarray

The lists that belong to your team.

metaobject

The metas information.

Endpoint

GET

https://api.thecompaniesapi.com/v2/lists

API response

{lists :[{analytics :{…},createdAt :"2022-04-01T13:07:14.000+00:00",dynamic :false,id :4246,imported :false,integrations :[…],name :"US Companies using Node.js",processActive :false,processingAt :"2022-04-01T13:07:15.000+00:00",processInitialized :true,query :[…],},{analytics :{…},createdAt :"2022-02-22T07:23:52.000+00:00",dynamic :false,id :3837,imported :false,integrations :[ ],name :"Edtech Companies",processActive :false,processingAt :"2022-02-22T07:23:53.000+00:00",processInitialized :true,query :[…],},],meta :{currentPage :1,firstPage :1,lastPage :1,perPage :10,total :4,},}