---
title: "GET /v1/lists/"
method: GET
path: "/v1/lists/"
---

# GET /v1/lists/

`GET /v1/lists/`

## Request

- Base URL: `https://api.servicegraph.co`
- URL: `https://api.servicegraph.co/v1/lists/`
- Auth: HTTP bearer

Paginated list of the caller's firm lists. Pass `?contains_apex=foo.com` to also include `item_id` per list (uuid when the list contains the apex, null otherwise) — used by the "Add to list" modal to render one-click toggles.

## Query parameters

- `limit` integer
- `offset` integer
- `contains_apex` string

## Response `200`

Default Response

---

[API](https://skmtc.dev/servicegraph/apis/servicegraph-api.md) · [All operations](https://skmtc.dev/servicegraph/apis/servicegraph-api/llms.txt) · [OpenAPI document](https://skmtc.dev/servicegraph/apis/servicegraph-api/revisions/f2f2f945c796?raw)