The Companies API LogoThe Companies API Logo
APICompaniesUse casesPricing
LoginLogin

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

Free

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,},}
A glowing background image to highlight the titleA glowing background image to highlight the title
© 2025 The Companies API
  • Updates
  • Terms
  • Privacy
  • FAQ
  • Status

Fast-growing SaaS companies with remote teams