---
title: "List the connected user's own lists"
method: GET
path: "/api/v1/me/lists"
tags: ["lists"]
---

# List the connected user's own lists

`GET /api/v1/me/lists`

## Request

- Base URL: `https://www.listdrop.co`
- URL: `https://www.listdrop.co/api/v1/me/lists`
- Auth: OAuth 2 (authorization code, authorization URL `https://www.listdrop.co/oauth/authorize`, token URL `https://www.listdrop.co/api/oauth/token`, scopes: `lists:read`)

Every list owned by the user the OAuth token belongs to — private ones included (the token holder is the owner). Requires the lists:read scope. This is the only endpoint that can see private lists.

## Response `200`

The user's lists.

- MyLists
  - `lists` object[], required
    - `id` string, required
    - `title` string, required
    - `emoji` string, nullable
    - `isPublic` boolean, required
    - `itemCount` integer, required
    - `followerCount` integer, required
    - `url` string, uri, required
    - `updatedAt` string, date-time, required

## Other responses

- `401`: Missing/invalid bearer token, or missing the lists:read scope.

---

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