> ## 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. # Change a listing's price > **Scope:** `write:listings` (needs a linked account). **Changes data.** Changes the price of one of your active fixed-price listings in place, in one transaction. The listing keeps its `listing_id`. The limits are the same as List a card, and the price is rounded to the cent. Sending the price a listing already has writes nothing and answers `200`, as long as it's still within the limits. ## OpenAPI ````yaml /partner-api/openapi.yaml patch /api/partner/v1/listings/{listing_id} 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/{listing_id}: patch: tags: - Marketplace summary: Change a listing's price description: >- **Scope:** `write:listings` (needs a linked account). **Changes data.** Changes the price of one of your active fixed-price listings in place, in one transaction. The listing keeps its `listing_id`. The limits are the same as List a card, and the price is rounded to the cent. Sending the price a listing already has writes nothing and answers `200`, as long as it's still within the limits. operationId: updateListingPrice parameters: - name: listing_id in: path required: true description: The listing, from Your listings or a listed card in Get vault. schema: type: string format: uuid example: 5f1c2a90-0000-4000-8000-000000000001 requestBody: required: true content: application/json: schema: type: object required: - price properties: price: type: number exclusiveMinimum: 0 description: The new asking price in USD. example: price: 52.5 responses: '200': description: The new price. content: application/json: schema: type: object required: - listing_id - card_id - category - price - previous_price - seller_fee - payout - updated_at properties: listing_id: type: string card_id: type: string category: type: string price: type: number description: The new price, rounded to the cent. previous_price: type: number seller_fee: type: number payout: type: number description: '`price` − `seller_fee`.' updated_at: type: - string - 'null' example: listing_id: 5f1c… card_id: 0e94dc61-… category: pokemon price: 52.5 previous_price: 45 seller_fee: 1 payout: 51.5 updated_at: '2026-10-28T20:02:11Z' '400': description: >- - No `code`: the listing id isn't a UUID, or `price` isn't a positive number. - `PRICE_BELOW_MINIMUM`: under $5. The body has `min_price` and `max_price`. - `PRICE_ABOVE_MAXIMUM`: over the larger of $5 and 2× market value. The body has `min_price` and `max_price`. - `NOT_FIXED_PRICE`: the listing is a Dutch auction, whose price follows its schedule. content: application/json: schema: allOf: - $ref: '#/components/schemas/Error' - type: object properties: code: type: string enum: - PRICE_BELOW_MINIMUM - PRICE_ABOVE_MAXIMUM - NOT_FIXED_PRICE min_price: type: number max_price: type: - number - 'null' description: '`null` when the card has no market value, so no cap.' listing_type: type: string example: error: Listings must be priced at least $5 code: PRICE_BELOW_MINIMUM min_price: 5 max_price: 76.86 '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. - `FEATURE_RESTRICTED`: the marketplace is switched off for the account (`capability: "marketplace"`). Contact us. content: application/json: schema: $ref: '#/components/schemas/RestrictedError' '404': description: >- `LISTING_NOT_FOUND`: no listing with this id belongs to your account. content: application/json: schema: allOf: - $ref: '#/components/schemas/Error' - type: object properties: code: type: string enum: - LISTING_NOT_FOUND '409': description: >- Nothing was written. - `LISTING_NOT_ACTIVE`: the listing sold, was taken down or expired, or its card left your account. An active listing whose `category` is `null` gets it too. Once the listing has closed, the body has its `status`. - `LISTING_CHANGED`: another change to the listing landed first, and the listing is still active. Read it again and retry. content: application/json: schema: allOf: - $ref: '#/components/schemas/Error' - type: object properties: code: type: string enum: - LISTING_NOT_ACTIVE - LISTING_CHANGED status: type: string '500': description: >- A database error. Send the same price again. That finishes the change, or writes nothing if it had already landed. content: application/json: schema: $ref: '#/components/schemas/Error' '503': description: >- We couldn't read your account just then. Nothing was written. 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 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.