> ## 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. # Card activity > **Scope:** `read:catalog` A card's recent sales and listings, newest first. Nobody is named. Trades that are not market prices (a buy by CatchBack staff or test accounts, or a seller buying their own listing) are left out. Cached for up to a minute. ## OpenAPI ````yaml /partner-api/openapi.yaml get /api/partner/v1/cards/{id}/activity openapi: 3.1.0 info: title: CatchBack Partner API version: 1.0.0 summary: Open packs, trade cards, read card data and ship vaulted cards. description: >- The Partner API acts on one CatchBack account with its real CatchCoins balance. Several operations here move money or data, so read [Idempotency](/partner-api/idempotency) before you call them. Error bodies are JSON with a human-readable `error` and, where you might branch on it, a machine-readable `code`. Branch on the status and the `code`, because the `error` text can change. New fields can be added to any response. contact: name: CatchBack support email: catchbackcards@gmail.com servers: - url: https://catchbackcards.com description: Production. Every call acts on real money and real inventory. security: - bearerAuth: [] tags: - name: Gacha description: Open packs, see what they can pull, check a pull, and sell cards back. - name: Marketplace description: Search and buy cards, and manage your own listings. - name: Metadata description: Look cards up by id or cert, with price history and recent activity. - name: Shipping description: Estimate, create and track shipments of cards you hold. - name: Account description: Your key, balance, limits, vault and order history, across every rail. - name: Funding description: Deposit and withdraw your balance in USDC. - name: Testing description: Test logins for trying CatchBack without real money. - name: Webhooks description: Signed POSTs we send to your URL when something happens on your account. paths: /api/partner/v1/cards/{id}/activity: get: tags: - Metadata summary: Card activity description: >- **Scope:** `read:catalog` A card's recent sales and listings, newest first. Nobody is named. Trades that are not market prices (a buy by CatchBack staff or test accounts, or a seller buying their own listing) are left out. Cached for up to a minute. operationId: getCardActivity parameters: - $ref: '#/components/parameters/CardId' - $ref: '#/components/parameters/LookupCategory' - $ref: '#/components/parameters/HistoryDays' - name: limit in: query description: >- The most sales, and the most listings, returned. Outside 1–50 is a `400`. schema: type: integer minimum: 1 maximum: 50 default: 20 responses: '200': description: The sales and listings. content: application/json: schema: type: object required: - card_id - category - days - limit - since - sales - listings properties: card_id: type: string category: type: string days: type: integer limit: type: integer since: type: string format: date-time sales: type: array items: type: object required: - sale_id - sold_at - price - source - listing_id - listing_type properties: sale_id: type: string sold_at: type: string price: type: number source: type: string enum: - shop - listing listing_id: type: - string - 'null' listing_type: type: - string - 'null' listings: type: array items: type: object required: - listing_id - listing_type - status - price - listed_at - sold_at properties: listing_id: type: string listing_type: type: string status: type: string price: type: number listed_at: type: string sold_at: type: - string - 'null' example: card_id: 0e94dc61-… category: pokemon days: 90 limit: 20 since: '2026-07-30T18:00:00.000Z' sales: - sale_id: a17e… sold_at: '2026-10-20T15:02:44Z' price: 395 source: listing listing_id: 5f1c… listing_type: fixed_price - sale_id: 93c2… sold_at: '2026-09-02T11:40:09Z' price: 360 source: shop listing_id: null listing_type: null listings: - listing_id: 5f1c… listing_type: fixed_price status: sold price: 395 listed_at: '2026-10-18T09:12:00Z' sold_at: '2026-10-20T15:02:44Z' '400': description: >- A malformed card id, an unknown `category`, `days` outside 1–365, or `limit` outside 1–50. content: application/json: schema: $ref: '#/components/schemas/Error' '401': $ref: '#/components/responses/Unauthorized' '403': description: The key lacks `read:catalog`. content: application/json: schema: $ref: '#/components/schemas/Error' '404': description: No card has this id. content: application/json: schema: $ref: '#/components/schemas/Error' '500': $ref: '#/components/responses/ServerError' security: - bearerAuth: - read:catalog components: parameters: CardId: name: id in: path required: true description: 'A card id: `item.id` or `card_id` from any other endpoint.' schema: type: string pattern: ^[A-Za-z0-9_-]{1,128}$ example: 0e94dc61-5a2f-4b1e-9c3d-7f8a1b2c3d4e LookupCategory: name: category in: query description: >- The card's catalog, if you know it. Without it, every catalog is searched. schema: $ref: '#/components/schemas/CardCategory' HistoryDays: name: days in: query description: How many days back from now. Outside 1–365 is a `400`. schema: type: integer minimum: 1 maximum: 365 default: 90 schemas: Error: type: object required: - error properties: error: type: string description: >- For people. The text can change, so branch on the status and the `code`. code: type: string description: Machine-readable, where you might branch on it. CardCategory: type: string description: A card's catalog. `goods` is luxury goods and `singles` is raw singles. enum: - pokemon - onepiece - sports - riftbound - watches - goods - singles responses: Unauthorized: description: A missing, malformed, disabled or unknown API key. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: Missing or malformed API key ServerError: description: An error on our side. Retry with backoff. content: application/json: schema: $ref: '#/components/schemas/Error' securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: cb_live_<48 hex> description: >- Your API key, sent as a bearer token. Keep it on your server. See [Authentication](/partner-api/authentication). A request from a location we refuse gets a `403` with `Access denied`, whether or not it has a valid key: [where you can call from](/partner-api/errors-and-limits#where-you-can-call-from). ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.