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,processInitialized :true,processingAt : "2022-04-01T13:07:15.000+00:00" ,query :[…],},{analytics :{…},createdAt : "2022-02-22T07:23:52.000+00:00" ,dynamic :false,id :3837,imported :false,integrations :[ ],name : "Edtech Companies" ,processActive :false,processInitialized :true,processingAt : "2022-02-22T07:23:53.000+00:00" ,query :[…],},],meta :{currentPage :1,firstPage :1,lastPage :1,perPage :10,total :4,},}