> ## 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 orders > **Scope:** `read:account` (needs a linked account). Your pack purchases, card purchases, sell-backs (one order per card) and sales of your listings, newest first. Shipment charges, money in and withdrawals aren't here: to reconcile your balance, use Balance history. The history belongs to the account, not the key. Purchases and sell-backs made in our app are left out. The window is capped at 31 days. Page with `next_cursor`: see [Pagination](/partner-api/pagination#cursor-pages). ## OpenAPI ````yaml /partner-api/openapi.yaml get /api/partner/v1/orders 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/orders: get: tags: - Account summary: List orders description: >- **Scope:** `read:account` (needs a linked account). Your pack purchases, card purchases, sell-backs (one order per card) and sales of your listings, newest first. Shipment charges, money in and withdrawals aren't here: to reconcile your balance, use Balance history. The history belongs to the account, not the key. Purchases and sell-backs made in our app are left out. The window is capped at 31 days. Page with `next_cursor`: see [Pagination](/partner-api/pagination#cursor-pages). operationId: listOrders parameters: - name: type in: query description: Only orders of this kind. Leave it out for all four. schema: $ref: '#/components/schemas/OrderType' - $ref: '#/components/parameters/Since' - $ref: '#/components/parameters/Until' - name: limit in: query description: Orders per page, 1–100. A higher value is treated as 100. schema: type: integer minimum: 1 maximum: 100 default: 50 - name: cursor in: query description: >- `next_cursor` from the previous page, unchanged. It carries that page's window and type, so `since`, `until` and `type` are ignored when you send it. schema: type: string responses: '200': description: One page of orders. content: application/json: schema: type: object required: - since - until - type - limit - has_more - next_cursor - orders properties: since: type: string format: date-time until: type: string format: date-time type: anyOf: - $ref: '#/components/schemas/OrderType' - type: 'null' limit: type: integer has_more: type: boolean next_cursor: type: - string - 'null' description: >- Send it as `cursor` for the next page. `null` on the last page. orders: type: array items: $ref: '#/components/schemas/Order' example: since: '2026-10-01T00:00:00.000Z' until: '2026-10-31T00:00:00.000Z' type: null limit: 50 has_more: false next_cursor: null orders: - checkout_id: 3e1ab17c-… order_id: order-1042 type: pack_purchase status: completed created_at: '2026-10-20T04:54:57.373+00:00' completed_at: '2026-10-20T04:54:58.563+00:00' amount: 25 fee: 0 balance_change: -25 reconciled: false pack_type: bronze quantity: 1 pull_ids: - e9d27918-… card_id: null listing_id: null transaction_id: null '400': description: >- An unknown `type`, a malformed or inverted window, a window over 31 days, or a cursor not passed back unchanged. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: >- Invalid cursor: pass next_cursor from the previous page unchanged '401': $ref: '#/components/responses/Unauthorized' '403': description: The key lacks `read:account` or isn't linked to an account. content: application/json: schema: $ref: '#/components/schemas/Error' '500': $ref: '#/components/responses/ServerError' security: - bearerAuth: - read:account components: schemas: OrderType: type: string enum: - pack_purchase - card_purchase - sell_back - listing_sale Order: type: object required: - checkout_id - order_id - type - status - created_at - completed_at - amount - fee - balance_change - reconciled - pack_type - quantity - pull_ids - card_id - listing_id - transaction_id properties: checkout_id: type: string description: The order's id. Get an order takes it. order_id: type: - string - 'null' description: >- The `Idempotency-Key` you sent with a purchase. `null` for a sell-back or a sale. type: $ref: '#/components/schemas/OrderType' status: type: string description: >- `completed`, or `pending` while a purchase is still running or held for review. New values can be added, so don't fail on one you don't know. created_at: type: string completed_at: type: - string - 'null' amount: type: - number - 'null' description: >- What a purchase charged (a card buy includes its $1 fee), what a sell-back paid, or what a listing sold for, in USD. fee: type: - number - 'null' description: >- The $1 buyer fee on a card buy or the $1 seller fee on a sale. `0` otherwise. balance_change: type: - number - 'null' description: >- The order's effect on your balance. `null` until something shows the order was charged. reconciled: type: boolean description: >- The order went through but its response was lost, and we closed it from our own records. pack_type: type: - string - 'null' quantity: type: - integer - 'null' pull_ids: type: array items: type: string card_id: type: - string - 'null' listing_id: type: - string - 'null' transaction_id: type: - string - 'null' description: For a card buy, the `purchase_id` that Get vault and Sell back use. 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. parameters: Since: name: since in: query description: ISO 8601, inclusive. Defaults to `until` minus 7 days. schema: type: string format: date-time example: '2026-10-01T00:00:00Z' Until: name: until in: query description: ISO 8601, inclusive. Defaults to now. At most 31 days after `since`. schema: type: string format: date-time example: '2026-10-31T00:00:00Z' 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.