> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whop.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Retrieve Card

> Retrieves a single card by its icrd_ identifier, including its secrets (full card number, CVC, and cardholder name) for active cards.



## OpenAPI

````yaml /openapi/api-v1-native.yml get /cards/{card_id}
openapi: 3.1.0
info:
  title: Whop API
  description: >-
    Hand-written V1 endpoints. Merged into the GraphqlRestProxy-generated schema
    at build time.
  version: v1
servers:
  - url: https://{defaultHost}
    variables:
      defaultHost:
        default: api.whop.com/api/v1
security: []
paths:
  /cards/{card_id}:
    parameters:
      - $ref: '#/components/parameters/ApiVersionDate'
      - name: card_id
        in: path
        required: true
        schema:
          type: string
        description: Card ID to retrieve, prefixed `icrd_`.
    get:
      tags:
        - Cards
      summary: Retrieve Card
      description: >-
        Retrieves a single card by its icrd_ identifier, including its secrets
        (full card number, CVC, and cardholder name) for active cards.
      operationId: retrieveCard
      parameters:
        - name: account_id
          in: query
          required: false
          schema:
            type: string
          description: The owning account ID (a biz_ identifier). Provide this or user_id.
        - name: user_id
          in: query
          required: false
          schema:
            type: string
          description: The owning user ID (a user_ identifier). Provide this or account_id.
      responses:
        '200':
          description: card retrieved with secrets
          content:
            application/json:
              schema:
                type: object
                properties:
                  object:
                    type: string
                    enum:
                      - card
                  id:
                    type: string
                    description: Card ID, prefixed `icrd_`.
                  name:
                    type:
                      - string
                      - 'null'
                    description: Card display name.
                  type:
                    type:
                      - string
                      - 'null'
                    enum:
                      - null
                      - virtual
                      - physical
                    description: The card type.
                  status:
                    type:
                      - string
                      - 'null'
                    enum:
                      - null
                      - active
                      - frozen
                      - canceled
                      - invited
                    description: The card status.
                  last4:
                    type:
                      - string
                      - 'null'
                    description: >-
                      Last four digits of the card number. `null` for pending
                      invitation cards.
                  expiration_month:
                    type:
                      - string
                      - 'null'
                    description: Card expiration month.
                  expiration_year:
                    type:
                      - string
                      - 'null'
                    description: Card expiration year.
                  user_id:
                    type:
                      - string
                      - 'null'
                    description: Cardholder user ID, prefixed `user_`, when assigned.
                  spent_last_month:
                    type:
                      - integer
                      - 'null'
                    description: Total spend in the last 30 days, in cents.
                  limit:
                    type:
                      - object
                      - 'null'
                    description: The spending limit configuration.
                    properties:
                      amount:
                        type: number
                        description: The limit amount in dollars.
                      frequency:
                        type: string
                        description: >-
                          Limit window, for example `per24HourPeriod` or
                          `perAuthorization`.
                    required:
                      - amount
                      - frequency
                  billing:
                    type:
                      - object
                      - 'null'
                    description: The billing address.
                    properties:
                      line1:
                        type:
                          - string
                          - 'null'
                        description: Street address line 1.
                      line2:
                        type:
                          - string
                          - 'null'
                        description: Street address line 2.
                      city:
                        type:
                          - string
                          - 'null'
                        description: Billing city.
                      region:
                        type:
                          - string
                          - 'null'
                        description: Billing region or state.
                      postal_code:
                        type:
                          - string
                          - 'null'
                        description: Billing postal code.
                      country_code:
                        type:
                          - string
                          - 'null'
                        description: Billing country code.
                    required:
                      - line1
                      - line2
                      - city
                      - region
                      - postal_code
                      - country_code
                  created_at:
                    type:
                      - string
                      - 'null'
                    format: date-time
                    description: When the card was created.
                  canceled_at:
                    type:
                      - string
                      - 'null'
                    format: date-time
                    description: When the card was canceled.
                  secrets:
                    type:
                      - object
                      - 'null'
                    description: >-
                      Sensitive card details. Present only on `GET
                      /cards/:card_id` for active cards; `null` when the card is
                      inactive or details cannot be retrieved.
                    properties:
                      card_number:
                        type: string
                        description: Full card number.
                      cvc:
                        type: string
                        description: Card verification code.
                      name_on_card:
                        type:
                          - string
                          - 'null'
                        description: Cardholder name printed on the card.
                    required:
                      - card_number
                      - cvc
                      - name_on_card
                required:
                  - object
                  - id
                  - name
                  - type
                  - status
                  - last4
                  - expiration_month
                  - expiration_year
                  - user_id
                  - spent_last_month
                  - limit
                  - billing
                  - created_at
                  - canceled_at
        '404':
          $ref: '#/components/responses/NotFound'
          description: card not found
      security:
        - bearerAuth:
            - payout:account:read
components:
  parameters:
    ApiVersionDate:
      name: Api-Version-Date
      in: header
      required: false
      schema:
        type: string
        format: date
        example: '2026-07-01'
      description: Pins the request to a dated API version.
  responses:
    NotFound:
      description: Resource not found
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/V1ErrorResponse'
  schemas:
    V1ErrorResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            type:
              type: string
              description: Machine-readable error code.
            message:
              type: string
              description: Human-readable error message.
          required:
            - type
            - message
      required:
        - error
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: auth-scheme
      description: >-
        An account API key, account scoped JWT, app API key, or user OAuth
        token.

````