> ## Documentation Index
> Fetch the complete documentation index at: https://catchbackcards.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Your listings

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

Scope: `read:account` · MCP tool: `get_listings`

[Search cards](https://catchbackcards.mintlify.site/partner-api/endpoints/search-cards.md) 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](https://catchbackcards.mintlify.site/partner-api/endpoints/update-listing-price.md). 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](https://catchbackcards.mintlify.site/partner-api/pagination.md).

**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.

**listing**

**listing\_id** `string`

Send it to [Change a listing's price](https://catchbackcards.mintlify.site/partner-api/endpoints/update-listing-price.md).

**card\_id** `string`

**category** `string | null`

The card's catalog. `null` on some older listings, which [Change a listing's price](https://catchbackcards.mintlify.site/partner-api/endpoints/update-listing-price.md) answers with `409 LISTING_NOT_ACTIVE`.

**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 | null`

When the listing last changed, a price change included.

**item** `object | null`

A [card object](https://catchbackcards.mintlify.site/partner-api/card-object.md), 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 |

```bash cURL theme={null}
curl "https://catchbackcards.com/api/partner/v1/listings?page=1&per_page=100" \
  -H "Authorization: Bearer $CATCHBACK_KEY"
```

```json 200 (abridged) theme={null}
{
  "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
      }
    }
  ]
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.