---
title: "Get one listing"
method: GET
path: "/api/v1/listings/{id}"
---

# Get one listing

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

## Request

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

## Path parameters

- `id` string, uuid, required

## Response `200`

Listing detail.

- object
  - `listing` Listing, required
    - `id` string, uuid, required
    - `title` string, required
    - `description` string
    - `type` 'GOOD' | 'SERVICE' | 'BOTH', required
    - `category` string, required
    - `subcategory` string, nullable
    - `condition` 'NEW' | 'LIKE_NEW' | 'GOOD' | 'FAIR' | 'POOR' | 'null', nullable
    - `images` string[]
    - `want_tags` string[]
    - `want_description` string, nullable
    - `estimated_value_usd` number, nullable
    - `location_city` string, nullable
    - `listed_by_agent` boolean
    - `is_example` boolean: A labelled demo listing, not real supply.
    - `kind` 'offer' | 'wanted', required
    - `pickup` boolean
    - `ships` boolean
    - `view_count` number
    - `status` string: Detail only: ACTIVE, PAUSED, DRAFT, TRADED or REMOVED.
    - `created_at` string, date-time, required
    - `user` ListingOwner
      - `id` string, uuid
      - `display_name` string
      - `rating_avg` number
      - `trayd_count` number
      - `city` string, nullable
      - `state_region` string, nullable

## Other responses

- `404`: Not found.
- `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)