---
title: "Remove your listing"
method: DELETE
path: "/api/v1/listings/{id}"
---

# Remove your listing

`DELETE /api/v1/listings/{id}`

## Request

- Base URL: `https://traydstar.com`
- URL: `https://traydstar.com/api/v1/listings/{id}`
- Auth: HTTP bearer

Scope: propose. Takes the listing off the marketplace and closes pending proposals that involve it. Refused (409) while it is part of a trade in progress.

## Path parameters

- `id` string, uuid, required

## Response `200`

{ success, closed_proposals }

## Other responses

- `404`: Not your listing.
- `409`: Traded, or part of a trade in progress.
- `default`: Error.

---

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