List items
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.
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)
Query parameters
Set to "true" to include soft-deleted items. Any other non-empty value is a 400, never silently treated as false — a silently-dropped tombstone reads as "this listing never existed" to the caller.
Response
Items list.
Changes
No recorded changes to this operation across all 1 revision of this API.