---
title: "Get binder contents grouped by shelf"
method: GET
path: "/api/binders/{id}"
tags: ["Binders", "Collectibles and packs"]
---

# Get binder contents grouped by shelf

`GET /api/binders/{id}`

## Request

- Base URL: `https://app.d-sports.org`
- URL: `https://app.d-sports.org/api/binders/{id}`
- Auth: HTTP bearer

Data: { binder, shelves }. Each shelf card adds serial: CardSerial | null — the lowest serial among the owner's copies of that collectible (ties: earliest mint); null when no copy has a recorded serial. Each shelf card adds player: CardPlayer | null at the top level of the card (next to serial): the roster player linked to that collectible; null when none is linked. Each shelf card adds lockedBy and lockedQuantity (BinderLockedCard): the listing/offer lock on the owner's holdings of that collectible in the binder's wallet. lockedQuantity is a reserved copy count capped at the card's quantity, not the inventory reads' 0 = whole row encoding. A PIN-protected binder without a valid token returns metadata only, with no lock data. Binder metadata includes coverStyle (built cover design, or null for classic).

## Path parameters

- `id` string, required

## Response `200`

{ binder, shelves }

- object
  - `data` object
    - `shelves` object: Cards keyed by shelf.

## Changes

- **2026-11-18** `6de639c52609`: 1 info
  - added the media type `application/json` for the response with the status `200`
- **2026-08-16** `16bfbac187d7`: 1 info
  - endpoint added

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