---
title: "List items"
method: GET
path: "/api/items"
tags: ["Listings"]
---

# List items

`GET /api/items`

## Request

- Base URL: `https://clearlist.me`
- URL: `https://clearlist.me/api/items`
- Auth: one of:
  - API key in header `X-ClearList-API-Key`
  - OAuth 2 (authorization code, authorization URL `https://clearlist.me/oauth/authorize`, token URL `https://clearlist.me/api/oauth/token`)

Returns the authenticated seller's items. Soft-deleted items (tombstones) are hidden unless `include_deleted=true`, which is the only way to recover an item_id for POST /api/items/{id}/restore after the deleting session is gone. Tombstone rows are enriched with `restorable` (boolean), `restorable_until` (ISO timestamp — the field to trust) and `restore_hours_remaining` (countdown, stale the moment it is read); tombstones past the window still appear, flagged `restorable: false`, until the purge collects them.

## Query parameters

- `include_deleted` 'true' | 'false'

## Response `200`

Items list.

- object
  - `success` boolean
  - `data` object
    - `items` object[]

## Other responses

- `400`: Invalid or missing parameters.
- `401`: Missing or invalid API key.
- `429`: Too many requests.
- `500`: Unexpected server error.

---

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