> ## 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.

# Who am I

> **Scope:** none, any valid key.

Which key this is, its scopes, and the CatchBack account it acts as. An unlinked key gets `linked: false` here, while the account endpoints answer `403` for it.



## OpenAPI

````yaml /partner-api/openapi.yaml get /api/partner/v1/me
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/me:
    get:
      tags:
        - Account
      summary: Who am I
      description: >-
        **Scope:** none, any valid key.


        Which key this is, its scopes, and the CatchBack account it acts as. An
        unlinked key gets `linked: false` here, while the account endpoints
        answer `403` for it.
      operationId: whoAmI
      responses:
        '200':
          description: The key and its account.
          content:
            application/json:
              schema:
                type: object
                required:
                  - key
                  - linked
                  - account
                properties:
                  key:
                    type: object
                    required:
                      - name
                      - scopes
                    properties:
                      name:
                        type: string
                      scopes:
                        type: array
                        items:
                          type: string
                  linked:
                    type: boolean
                  account:
                    type:
                      - object
                      - 'null'
                    description: '`null` when `linked` is `false`.'
                    properties:
                      id:
                        type: string
                      username:
                        type:
                          - string
                          - 'null'
                      profile_url:
                        type:
                          - string
                          - 'null'
              example:
                key:
                  name: acme
                  scopes:
                    - read:catalog
                    - read:account
                    - rip:packs
                linked: true
                account:
                  id: 6f1c0000-…
                  username: acme-cards
                  profile_url: https://catchbackcards.com/user/acme-cards
        '401':
          $ref: '#/components/responses/Unauthorized'
        '500':
          $ref: '#/components/responses/ServerError'
components:
  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'
  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.
  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.