> ## 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 test accounts

> **Scope:** `create:test_accounts`, opt-in, granted on request.

The test accounts this key made, the newest 100, including ones that have ended. Another key's accounts aren't listed, even on the same account. Passwords are never shown again.



## OpenAPI

````yaml /partner-api/openapi.yaml get /api/partner/v1/test-accounts
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 Wallet 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: support@catchbackcards.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/test-accounts:
    get:
      tags:
        - Testing
      summary: List test accounts
      description: >-
        **Scope:** `create:test_accounts`, opt-in, granted on request.


        The test accounts this key made, the newest 100, including ones that
        have ended. Another key's accounts aren't listed, even on the same
        account. Passwords are never shown again.
      operationId: listTestAccounts
      responses:
        '200':
          description: The test accounts, newest first.
          content:
            application/json:
              schema:
                type: object
                required:
                  - accounts
                properties:
                  accounts:
                    type: array
                    items:
                      $ref: '#/components/schemas/TestAccount'
              example:
                accounts:
                  - user_id: 3b0e0000-…
                    email: acme-9f2c41ab@test.catchbackcards.com
                    username: swiftFalcon4821
                    balance: 9875
                    created_at: '2026-10-21T18:00:00Z'
                    expires_at: '2026-11-20T18:00:00Z'
                    active: true
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          description: The key lacks `create:test_accounts`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: We couldn't read the list. Retry with backoff.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - bearerAuth:
            - create:test_accounts
components:
  schemas:
    TestAccount:
      type: object
      required:
        - user_id
        - email
        - username
        - balance
        - created_at
        - expires_at
        - active
      properties:
        user_id:
          type: string
          description: The account's id.
        email:
          type: string
          description: The login, a made-up address nobody reads.
        username:
          type:
            - string
            - 'null'
        balance:
          type:
            - number
            - 'null'
          description: The test balance in dollars. It isn't money and can't be withdrawn.
        created_at:
          type: string
        expires_at:
          type: string
          description: 30 days after it was created.
        active:
          type: boolean
          description: '`false` from its `expires_at`, or once it has been turned off.'
    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.
  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.