---
title: "Get user collectibles"
method: GET
path: "/api/user/collectibles"
tags: ["User"]
---

# Get user collectibles

`GET /api/user/collectibles`

## Request

- Base URL: `https://app.d-sports.org`
- URL: `https://app.d-sports.org/api/user/collectibles`
- Auth: HTTP bearer

Data: { collectibles }. Each item carries walletAddress (the wallet the copy was acquired into; null = pre-#928 legacy row), lockedBy and lockedQuantity. When set, returns only rows acquired into this wallet (case-insensitive). Omit to return every wallet's rows. Each item adds serial: CardSerial | null — the lowest serial among the user's copies of that collectible (ties: earliest mint); null when no copy has a recorded serial. Each item adds player: CardPlayer | null at the top level of the row (next to serial, not inside collectible): the roster player linked to that collectible; null when none is linked.

## Query parameters

- `walletAddress` string

## Response `200`

Collectibles data, including listing/offer lock metadata

- object
  - `data` object
    - `collectibles` InventoryLockedCollectible[]
      - `lockedBy` string, nullable: Lock token (`listing:<id>` or `offer:<id>`) while listed/offered; otherwise null.
      - `lockedQuantity` integer: Copies held by the lock; 0 with a token = whole row.
      - `collectible` object
        - `finish` string, nullable, required: Card finish id, or null when no finish is set.
        - `cardTemplate` CardTemplate, nullable, required: Render template that produced the card image currently being served.
          - `key` string, required
          - `version` integer, required

## Changes

- **2026-11-18** `6de639c52609`: 2 info
  - added the new optional `query` request parameter `walletAddress`
  - added the media type `application/json` for the response with the status `200`
- **2026-03-08** `120afc4ee72c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/changes/api/user/collectibles/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)
