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

# Get card



## OpenAPI

````yaml GET /cards/info
openapi: 3.1.0
info:
  title: Nadcab Labs Card Issuing API
  version: 1.0.0
  description: >-
    Issue and manage crypto-funded virtual and physical cards, cardholders,
    wallet deposits and remittances.
servers:
  - url: https://cc.nadcab.com/api/v1
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Card BINs
    description: List card BINs you can issue on.
  - name: Account
    description: Wallet balance, deposits and withdrawals.
  - name: API settings
    description: Webhook URL, IP allowlist and card data encryption key.
  - name: Cards
    description: Create, fund, freeze and close cards.
  - name: Cardholders
    description: Create and manage cardholders for B2C card programs.
  - name: Remittance
    description: Send fiat bank transfers funded from your wallet.
paths:
  /cards/info:
    get:
      tags:
        - Cards
      summary: Get card
      operationId: getCard
      parameters:
        - name: cardId
          in: query
          required: true
          description: Card ID or order ID
          schema:
            type: string
            example: CA2408221211158
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: integer
                  msg:
                    type: string
                  data:
                    $ref: '#/components/schemas/Card'
                required:
                  - code
                  - msg
                  - data
              example:
                code: 200
                msg: success
                data:
                  id: CA2506091558586
                  trade_id: 1f045076-6f86-6d9a-a559-0242ac110002
                  label: null
                  card_bin: '404038'
                  card_no: 404038******7947
                  cvv: '***'
                  currency: USD
                  available: '5.000'
                  pending: 0
                  frozen: 0
                  expire_date: '**/****'
                  holder_username: CJYJCK MKFRRSKK
                  holder_address:
                    city: Framingham
                    state: MA
                    country: US
                    postalCode: '01701'
                    addressLine1: 189 Danforth Street
                    addressLine2: ''
                  create_time: '2025-06-09 15:57:43'
                  status: 0
                  account_status: 0
                  holder_phone: '2015550123'
                  fee: '2.00'
                  holder_email: 25261639@qq.com
                  holder_phone_code: '1'
                  physical: 0
                  physical_status: 0
                  deliver_status: 0
                  consumption_scene_type: 2
                  consumption_scene_config:
                    - name: Anthropic
                      channel_id: 143
                    - name: Meta
                      channel_id: 232
                    - name: Uber
                      channel_id: 136
components:
  schemas:
    Card:
      type: object
      properties:
        id:
          type: string
          description: Card ID
        trade_id:
          type: string
          description: Card order ID. Transaction ID returned when the card was created
        currency:
          type: string
          description: Currency
        label:
          type: string
          description: Card label
        create_time:
          type: string
          description: Card created at
        card_bin:
          type: string
          description: BIN label
        card_no:
          type: string
          description: Full card number
        cvv:
          type: string
          description: Security code (CVV)
        expire_date:
          type: string
          description: Expiry date
        holder_username:
          type: string
          description: Cardholder name
        holder_address:
          type: object
          properties:
            city:
              type: string
              description: City
            state:
              type: string
              description: Region
            country:
              type: string
              description: Country
            postalCode:
              type: string
              description: Postal code
            addressLine1:
              type: string
              description: Address line 1
            addressLine2:
              type: string
              description: Address line 2
          required:
            - city
            - state
            - country
            - postalCode
            - addressLine1
          description: Cardholder billing address
        available:
          type: string
          description: Available balance
        pending:
          type: integer
          description: Pending balance
        frozen:
          type: integer
          description: Frozen balance
        fee:
          type: string
          description: Top-up fee rate (%)
        status:
          type: string
          description: 'Status (-1: locked, 0: active, 1: frozen, 2: closed, 3: closing)'
          enum:
            - '0'
            - '1'
            - '2'
            - '-1'
            - '3'
        holder_email:
          type: string
          description: Cardholder email
        holder_phone_code:
          type: string
          description: Cardholder phone country code
        physical:
          type: string
          description: 'Physical card (0: yes, 1: no)'
        physical_status:
          type: string
          description: >-
            Physical card activation status (0: awaiting verification, 1:
            awaiting activation, 2: activated)
        deliver_status:
          type: string
          description: >-
            Physical card shipping status (0: not requested, 1: awaiting
            shipping request, 2: in production, 3: shipped)
        consumption_scene_type:
          type: integer
          description: 'Spending scene type (0: unrestricted, 1: allowlist, 2: blocklist)'
        consumption_scene_config:
          type: object
          properties:
            channel_id:
              type: integer
              description: Scene ID
            name:
              type: string
              description: Scene name
          description: Spending scene settings
          required:
            - channel_id
            - name
      required:
        - id
        - trade_id
        - currency
        - create_time
        - card_bin
        - card_no
        - cvv
        - expire_date
        - holder_username
        - available
        - pending
        - frozen
        - fee
        - status
        - label
        - holder_email
        - holder_phone_code
        - physical
        - physical_status
        - deliver_status
        - consumption_scene_type
        - consumption_scene_config
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Your API key from Console → Settings → Key & Access, sent as
        `Authorization: Bearer ncl_...`.

````