> ## 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 a card > **Scope:** `write:listings` (needs a linked account). **Changes data.** Puts a card you hold up for sale at a fixed price. The price must be at least $5 and at most the larger of $5 and 2× the card's market value, and a card with no market value has no upper cap. The account needs a verified phone number. A listed card can't be sold back until you delist it. ## OpenAPI ````yaml /partner-api/openapi.yaml post /api/partner/v1/listings 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/listings: post: tags: - Marketplace summary: List a card description: >- **Scope:** `write:listings` (needs a linked account). **Changes data.** Puts a card you hold up for sale at a fixed price. The price must be at least $5 and at most the larger of $5 and 2× the card's market value, and a card with no market value has no upper cap. The account needs a verified phone number. A listed card can't be sold back until you delist it. operationId: listCard requestBody: required: true content: application/json: schema: type: object required: - card_id - price properties: card_id: type: string format: uuid description: A `card_id` from Get vault. price: type: number exclusiveMinimum: 0 description: Asking price in USD. example: card_id: 0e94dc61-5a2f-4b1e-9c3d-7f8a1b2c3d4e price: 45 responses: '200': description: The listing. content: application/json: schema: type: object required: - listing_id - card_id - price properties: listing_id: type: string card_id: type: string price: type: number example: listing_id: 5f1c… card_id: 0e94dc61-… price: 45 '400': description: >- - No `code`: `card_id` isn't a UUID, `price` isn't a positive number, you don't hold the card, it's already listed, the price is out of range, or the card can't be listed (shipped, archived, an energy card, a luxury goods item or a raw single). - `CARD_ON_PACK_HOLD`: the card came from a pack that holds its cards. Sell it back. content: application/json: schema: allOf: - $ref: '#/components/schemas/Error' - type: object properties: code: type: string enum: - CARD_ON_PACK_HOLD example: error: You do not hold this card '401': $ref: '#/components/responses/Unauthorized' '403': description: >- - The key lacks `write:listings` or isn't linked to an account. - `Phone verification required`. - The account can't list cards. - `You do not own this card`: the card isn't yours, which is also what a card that left your account a moment earlier can answer. - `FEATURE_RESTRICTED`: the marketplace is switched off for the account (`capability: "marketplace"`). Contact us. content: application/json: schema: $ref: '#/components/schemas/RestrictedError' '404': description: >- The card was gone by the time we created the listing. Read your vault and try again. content: application/json: schema: $ref: '#/components/schemas/Error' '409': description: >- The card changed while we were listing it. Read your vault and try again. content: application/json: schema: $ref: '#/components/schemas/Error' '500': $ref: '#/components/responses/ServerError' '503': description: >- We couldn't read your account just then. Nothing was listed. Retry shortly. content: application/json: schema: $ref: '#/components/schemas/Error' security: - bearerAuth: - write:listings components: 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. RestrictedError: allOf: - $ref: '#/components/schemas/Error' - type: object properties: code: type: string enum: - FEATURE_RESTRICTED capability: type: string description: What is switched off for the account. 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.