> ## 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. # List packs > **Scope:** `read:catalog` Exactly the packs [Buy packs](/partner-api/endpoints/buy-packs) will sell this key's account, at the price it charges, with live availability. A pack that is only out of stock stays in the list with `available: false` and a `reason`. A key with no linked account sees the public packs. A sealed product isn't in your vault: the Starter and the sealed mystery packs pay out sealed products, which aren't in Get vault, and the API can't sell them back, list them or ship them. ## OpenAPI ````yaml /partner-api/openapi.yaml get /api/partner/v1/catalog/packs 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/catalog/packs: get: tags: - Gacha summary: List packs description: >- **Scope:** `read:catalog` Exactly the packs [Buy packs](/partner-api/endpoints/buy-packs) will sell this key's account, at the price it charges, with live availability. A pack that is only out of stock stays in the list with `available: false` and a `reason`. A key with no linked account sees the public packs. A sealed product isn't in your vault: the Starter and the sealed mystery packs pay out sealed products, which aren't in Get vault, and the API can't sell them back, list them or ship them. operationId: listPacks parameters: - $ref: '#/components/parameters/PackCategory' responses: '200': description: The packs, cheapest first. content: application/json: schema: type: object required: - category - packs properties: category: $ref: '#/components/schemas/PackCategory' packs: type: array items: $ref: '#/components/schemas/Pack' example: category: pokemon packs: - pack_type: starter name: Starter Pack price: 8 available: false reason: Out of stock max_quantity: 1 risk_levels: - standard - pack_type: bronze name: Bronze Pack price: 25 available: true max_quantity: 10 risk_levels: - chill - standard - aggressive '400': description: Unknown `category`. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: 'Unknown category: pokemn' '401': $ref: '#/components/responses/Unauthorized' '403': description: The key lacks `read:catalog`. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: 'API key lacks required scope: read:catalog' '500': $ref: '#/components/responses/ServerError' security: - bearerAuth: - read:catalog components: parameters: PackCategory: name: category in: query description: The catalog. schema: $ref: '#/components/schemas/PackCategory' schemas: PackCategory: type: string description: A catalog that has packs and listings. enum: - pokemon - onepiece - sports - riftbound - watches default: pokemon Pack: type: object required: - pack_type - name - price - available - max_quantity - risk_levels properties: pack_type: type: string description: What Buy packs takes. name: type: string price: type: number description: Price per pack in USD, the amount charged. available: type: boolean description: >- Whether the pack can be opened right now. Buy packs refuses one that can't, with `409 PACK_UNAVAILABLE`, before charging anything. reason: type: string description: >- One of `Out of stock`, `Odds maintenance in progress`, `Restocking` or `Not available right now`. Only when `available` is `false`. max_quantity: type: integer description: The most in one request. risk_levels: type: array items: $ref: '#/components/schemas/RiskLevel' 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. RiskLevel: type: string enum: - chill - standard - aggressive default: standard 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.