# 查询卡片基础信息

> 查询卡片基础状态信息。

```yaml
openapi: 3.1.0
info:
  title: 查询卡片基础信息
  version: 1.0.0
  description: 查询卡片基础状态信息。
paths:
  /api/v1/merchant/card/getBasicInfo:
    post:
      summary: 查询卡片基础信息
      description: 查询卡片基础状态信息。
      parameters:
        - name: ApiKey
          in: header
          required: true
          description: Onerway 分配的发卡 API key 请求 Header。
          schema:
            type: string
            description: Onerway 分配的发卡 API key 请求 Header。
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                cardId:
                  type: integer
                  description: 卡片 ID。
              required:
                - cardId
            examples:
              default:
                summary: 查询卡片基础信息
                value:
                  cardId: 100001
      responses:
        "200":
          description: 成功
          content:
            application/json:
              schema:
                type: object
                properties:
                  respCode:
                    type: string
                    description: 业务响应码；`20000` 表示成功。
                  respMsg:
                    type: string
                    description: 响应信息。
                  data:
                    type:
                      - object
                      - "null"
                    properties:
                      cardId:
                        type: integer
                        description: 卡片 ID。
                      cardholderId:
                        type: integer
                        description: 持卡人 ID。
                      productId:
                        type: integer
                        description: 卡产品 ID。
                      status:
                        type: string
                        description: 卡片状态。
                        enum:
                          - PROCESSING
                          - INFO_REQUIRED
                          - FAILED
                          - ACTIVE
                          - FREEZING
                          - FROZEN
                          - SYSTEM_FROZEN
                          - SYSTEM_FREEZING
                          - UNFREEZING
                          - SYSTEM_UNFREEZING
                          - TERMINATING
                          - TERMINATED
                          - EXPIRED
                        x-enum-descriptions:
                          PROCESSING: 开卡处理中。
                          INFO_REQUIRED: 待补充信息。
                          FAILED: 开卡失败。
                          ACTIVE: 卡片可用。
                          FREEZING: 冻结处理中。
                          FROZEN: 卡片已冻结。
                          SYSTEM_FROZEN: 卡片被系统冻结。
                          SYSTEM_FREEZING: 系统冻结中。
                          UNFREEZING: 解冻处理中。
                          SYSTEM_UNFREEZING: 系统解冻中。
                          TERMINATING: 预注销。
                          TERMINATED: 已注销。
                          EXPIRED: 卡片已过期。
                      blockedFlag:
                        type: boolean
                        description: 卡片是否被阻断。
                    description: 卡片基础信息。
                    x-onerway-value:
                      nullable: true
                      when:
                        en: Returned as `null` when the query fails.
                        zh: 查询失败时返回 `null`。
              examples:
                success:
                  summary: 成功
                  value:
                    respCode: "20000"
                    respMsg: success
                    data:
                      cardId: 100001
                      cardholderId: 300001
                      productId: 1
                      status: ACTIVE
                      blockedFlag: false
```