---
title: "Browse active listings"
method: GET
path: "/api/v1/listings"
---

# Browse active listings

`GET /api/v1/listings`

## Request

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

Public. Filter with q (text search), category, subcategory, type (GOOD|SERVICE|BOTH), limit (max 100), offset. The launch category is 'Cameras & Photo'. Multi-word searches match word by word and are ranked, so an exact phrase isn't needed. Each listing has listed_by_agent.

## Query parameters

- `q` string
- `category` 'Cameras & Photo' | 'Electronics' | 'Collectibles' | 'Sports & Outdoors' | 'Home & Garden' | 'Clothing & Accessories' | 'Books & Media' | 'Vehicles & Parts' | 'Art & Crafts' | 'Other Goods' | 'Design Services' | 'Tech Services' | 'Creative Services' | 'Professional Services' | 'Home Services' | 'Other Services'
- `subcategory` string
- `type` 'GOOD' | 'SERVICE' | 'BOTH'
- `limit` integer
- `offset` integer
- `listed_by` 'agent' | 'person'
- `mine` 'true'
- `kind` 'offer' | 'wanted'
- `ships` 'true'
- `city` string
- `saved` 'true'

## Response `200`

Listings with owner display name, rating, and estimated USD value.

- ListingPage
  - `listings` 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
  - `limit` number, required
  - `offset` number, required
  - `has_more` boolean, required: True when another page exists at offset + limit.

## Other responses

- `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)