INinstantly
CompanyList

List company lists

Changed on

Requires one of the following scopes: supersearch_enrichments:read, supersearch_enrichments:all, all:read, all:all

get/api/v2/supersearch-enrichment/company-lists

Request

  • Base URL
    https://api.instantly.ai
  • URL
    https://api.instantly.ai/api/v2/supersearch-enrichment/company-lists
  • Auth
    HTTP bearer

Query parameters

limitinteger
Example:10

The number of items to return

starting_afterstring
Example:WyIyMDI2LTA3LTMwVDAwOjAwOjAwLjAwMFoiLCJsaXN0OjAxOGYyMyJd

Pagination cursor. Pass the next_starting_after value from the previous response. Takes precedence over the deprecated cursor when both are sent.

cursorstring
Example:WyIyMDI2LTA3LTMwVDAwOjAwOjAwLjAwMFoiLCJsaXN0OjAxOGYyMyJd

Deprecated alias of starting_after. Pass the next_cursor value from the previous response. Ignored when starting_after is also sent.

searchstring
Example:acme

Response

Default Response

next_starting_afterstring
next_cursorstring

Deprecated alias of next_starting_after, always identical to it.

totalinteger

Number of lists matching the request, counted exactly up to 10000. A workspace with more matches than that reports 10000.

Example response

{
  "data": [
    {
      "company_list_id": "018f23b7-92bb-7c64-a3d4-1ba53b8ad971",
      "name": "US SaaS companies",
      "provider_id": "fullenrich",
      "company_source_id": "fullenrich_company_search",
      "status": "PENDING",
      "terminal_reason": "NO_RESULTS",
      "requested_count": 10000,
      "company_count": 8742,
      "saved_count": 9100,
      "credits_charged": 10000,
      "timestamp_created": "2026-07-30T00:00:00.000Z",
      "timestamp_updated": "2026-07-30T00:00:00.000Z"
    }
  ],
  "next_starting_after": "WyIyMDI2LTA3LTMwVDAwOjAwOjAwLjAwMFoiLCJsaXN0OjAxOGYyMyJd",
  "next_cursor": "WyIyMDI2LTA3LTMwVDAwOjAwOjAwLjAwMFoiLCJsaXN0OjAxOGYyMyJd",
  "total": 137
}

Changes