Your listings

Your account’s active marketplace listings, newest first, with what each one pays you if it sells.

GET /api/partner/v1/listings

cURL

curl "https://catchbackcards.com/api/partner/v1/listings?page=1&per_page=100" \
  -H "Authorization: Bearer $CATCHBACK_KEY"

200

{
  "page": 1,
  "per_page": 100,
  "total": 1,
  "has_more": false,
  "listings": [
    {
      "listing_id": "5f1c2a90-…",
      "card_id": "0e94dc61-…",
      "category": "pokemon",
      "listing_type": "fixed_price",
      "price": 45,
      "seller_fee": 1,
      "payout": 44,
      "listed_at": "2026-10-28T19:56:28Z",
      "updated_at": "2026-10-28T19:56:28Z",
      "item": {
        "id": "0e94dc61-…",
        "category": "pokemon",
        "name": "Greavard",
        "grading_company": "PSA",
        "grading_rank": 9,
        "market_value": 38.43
      }
    }
  ]
}

Scope: read:account · MCP tool: get_listings

Search cards leaves your own listings out. This lists them: each listing_id, the card, its price, and your payout if it sells, which is the price less the $1 seller fee. Use the listing_id to change a listing’s price. A Dutch auction you started in our app shows here too, at its current auction price.

category · string

Only this catalog: pokemon, onepiece, sports, riftbound or watches. Leave it out for every catalog.

page · integer · default: "1"

1-based. See Pagination.

per_page · integer · default: "100"

1–200. A higher value is treated as 200.

Response

page · integer

per_page · integer

total · integer | null

Active listings across all pages.

has_more · boolean

Whether another page has listings.

listings · object[]

Newest first.

Show listing

listing_id · string

Send it to Change a listing’s price.

card_id · string

category · string | null

The card’s catalog. null on some older listings.

listing_type · string

fixed_price, or dutch_auction for a Dutch auction started in our app.

price · number

The listing’s price right now, in USD: what a buyer is charged for the card, before the $1 buyer fee. For a Dutch auction, its current auction price.</ResponseField> <ResponseField name="seller_fee" type="number">What a sale takes from your payout: $1.

payout · number

What your balance is credited if it sells at price: price − seller_fee.

listed_at · string

When you listed it.

updated_at · string

When the listing last changed, a price change included.

item · object | null

A card object, or null if we can’t load the card.

Errors

Status	When
400	An unknown category (the five above)
403	The key lacks read:account or isn’t linked to an account
500	We couldn’t load your listings. Retry with backoff

cURL

curl "https://catchbackcards.com/api/partner/v1/listings?page=1&per_page=100" \
  -H "Authorization: Bearer $CATCHBACK_KEY"

200

{
  "page": 1,
  "per_page": 100,
  "total": 1,
  "has_more": false,
  "listings": [
    {
      "listing_id": "5f1c2a90-…",
      "card_id": "0e94dc61-…",
      "category": "pokemon",
      "listing_type": "fixed_price",
      "price": 45,
      "seller_fee": 1,
      "payout": 44,
      "listed_at": "2026-10-28T19:56:28Z",
      "updated_at": "2026-10-28T19:56:28Z",
      "item": {
        "id": "0e94dc61-…",
        "category": "pokemon",
        "name": "Greavard",
        "grading_company": "PSA",
        "grading_rank": 9,
        "market_value": 38.43
      }
    }
  ]
}