---
title: "List marketplace listings"
method: GET
path: "/api/v1/marketplace"
tags: ["Marketplace", "Commerce and purchases"]
---

# List marketplace listings

`GET /api/v1/marketplace`

## Request

- Base URL: `https://app.d-sports.org`
- URL: `https://app.d-sports.org/api/v1/marketplace`
- Auth: one of:
  - HTTP bearer
  - none

Optional auth. Same handler as GET /api/v1/marketplace/listings. Viewer context personalizes serialized rows when a session is present.

## Query parameters

- `itemType` 'card' | 'pack'
- `listingType` 'sale' | 'auction' | 'trade' | 'all'
- `search` string
- `sort` 'recent' | 'price-asc' | 'price-desc' | 'ending-soon' | 'most-bids'
- `page` integer
- `limit` integer
- `minPrice` number
- `maxPrice` number
- `rarities` string
- `teams` string
- `leagues` string
- `sport` string
- `league` string
- `team` string
- `auctionState` 'all' | 'ending-soon' | 'just-started' | 'has-bids'
- `includeDemo` boolean

## Response `200`

{ success, data: { listings, totalCount, hasMore } }

## Other responses

- `400`: VALIDATION_ERROR

## Changes

- **2026-08-26** `9ad8c76f5ad5`: 1 info
  - the endpoint scheme security `bearerAuth` was added to the API
- **2026-08-26** `56093db9c295`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/changes/api/v1/marketplace/get.md)

---

[API](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api.md) - [All operations](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/llms.txt) - [OpenAPI document](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/revisions/63735cf90a04?raw)
