---
title: "Get list previews"
method: GET
path: "/lists"
tags: ["lists"]
---

# Get list previews

`GET /lists`

## Request

- Base URL: `https://api.leadsforge.ai`
- URL: `https://api.leadsforge.ai/lists`
- Auth: API key in header `Authorization`

Get previews of lists created by the user (for sidebar)

## Query parameters

- `search` string
- `offset` integer, required
- `limit` integer, required

## Response `200`

List previews

- GetListsResponse[]
  - `createdAt` string
  - `id` string
  - `name` string

## Other responses

- `400`: Bad Request
- `500`: Internal Server Error

---

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