# Get card PCI information

Gets sensitive PCI (Payment Card Industry) card data.

Calling this endpoint could change the status of `TEMPORARY` cards. For more information, refer to [Configuring temporary cards](https://developers.pismo.io/pismo-docs/docs/cards-overview-1#configuring-temporary-cards) in the [Cards management](https://developers.pismo.io/pismo-docs/docs/cards-overview-1) guide.

**Note:** This is a PCI endpoint, use the https://gw-pci.pismolabs.io environment.


# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "title": "Card issuing - Cards",
    "version": "1.4.6",
    "description": "Card endpoints API",
    "contact": {
      "name": "API Support",
      "url": "https://developers.pismo.io/support/"
    },
    "license": {
      "name": "Copyright Pismo"
    }
  },
  "servers": [
    {
      "url": "https://sandbox.pismolabs.io",
      "description": "Sandbox API server for testing."
    },
    {
      "url": "https://gw-pci.pismolabs.io",
      "description": "Sandbox PCI API server for testing"
    }
  ],
  "security": [
    {
      "BearerAuth": []
    }
  ],
  "tags": [
    {
      "name": "PCI",
      "description": "Card PCI/sensitive information endpoints"
    }
  ],
  "components": {
    "parameters": {
      "cardId": {
        "in": "path",
        "name": "cardId",
        "schema": {
          "type": "string"
        },
        "description": "Pismo card ID",
        "required": true
      }
    },
    "schemas": {
      "AccountID": {
        "type": "integer",
        "description": "Pismo account ID",
        "example": 7654776
      },
      "CardID2": {
        "type": "integer",
        "description": "Pismo card ID",
        "example": 123456
      },
      "CardPCIInfoResponse": {
        "type": "object",
        "description": "Card PCI (sensitive information) respomse object",
        "properties": {
          "org_id": {
            "$ref": "#/components/schemas/OrgID"
          },
          "card_id": {
            "$ref": "#/components/schemas/CardID2"
          },
          "service_code": {
            "$ref": "#/components/schemas/ServiceCode"
          },
          "correlation_id": {
            "$ref": "#/components/schemas/CorrelationID"
          },
          "account_id": {
            "$ref": "#/components/schemas/AccountID"
          },
          "type": {
            "$ref": "#/components/schemas/CardType"
          },
          "printed_name": {
            "$ref": "#/components/schemas/PrintedName"
          },
          "valid_until": {
            "$ref": "#/components/schemas/ValidUntil"
          },
          "expiration_date": {
            "$ref": "#/components/schemas/ExpirationDate"
          },
          "card_number": {
            "$ref": "#/components/schemas/PAN"
          },
          "issuing_date": {
            "$ref": "#/components/schemas/IssuingDate"
          },
          "cvv": {
            "$ref": "#/components/schemas/CVV"
          },
          "cvv_next_rotation_date": {
            "$ref": "#/components/schemas/cvvNextRotationDate"
          },
          "cvv_rotation_interval_hours": {
            "$ref": "#/components/schemas/cvvRotationInterval"
          },
          "password_updated": {
            "$ref": "#/components/schemas/PasswordUpdated"
          }
        }
      },
      "CardType": {
        "type": "string",
        "description": "Card type enum:\n * `PLASTIC` - Physical card - plastic or metal.\n * `VIRTUAL` - Digital card with fixed PAN and dynamic CVV.\n * `TEMPORARY` - Virtual card with a fixed PAN and CVV meant for short-term use, typically 24 hours. For more information, refer to [Configuring temporary cards](https://developers.pismo.io/pismo-docs/docs/cards-overview-1#configuring-temporary-cards) in the Cards management guide.\n * `RECURRING` - Virtual card with a fixed PAN and CVV originally meant for use with recurring subscriptions. This type is being **DEPRECATED** and it is recommended you use `VIRTUAL` instead. \n",
        "example": "VIRTUAL",
        "enum": [
          "PLASTIC",
          "VIRTUAL",
          "RECURRING",
          "TEMPORARY"
        ]
      },
      "CorrelationID": {
        "type": "string",
        "description": "Correlation ID used in request x-cid header. This  is used to link related API requests and events. For example, if a user makes an authorization request with 10 installments, this generates 1 authorization event and 10 transaction events all containing the same correlation ID. The x-cid can help the Pismo engineering team track everything related to a call. If this field isn't passed, one is generated. You can find the x-cid field in the response header from an API endpoint call.\n",
        "example": "3b56dbec-e509-9550-8c8c-ae5ab081e4d5"
      },
      "CVV": {
        "type": "string",
        "description": "\nCard Verification Value 2 (CVV2, also known as CVC2), a 3-digit security code contained in a card's signature strip, used for cardholder verification.\n",
        "example": "678"
      },
      "cvvNextRotationDate": {
        "type": "string",
        "description": "For virtual cards. Card CVV2/CVC2 next rotation in UTC date/time - format:yyyy-MM-ddThh:mm:ssZ\n",
        "format": "date-time"
      },
      "cvvRotationInterval": {
        "type": "integer",
        "description": "<b>REQUIRED</b> for a virtual card.  Virtual card CVV rotation interval in hours.\n\nTo force a rotation manually, call the [Rotate virtual card CVV](https://developers.pismo.io/pismo-docs/reference/post-v2-reset-cvv) endpoint.\n\nIf `0` is passed, the CVV will **NOT** be rotated.\n",
        "minimum": 1,
        "maximum": 4320,
        "example": 24
      },
      "ExpirationDate": {
        "type": "string",
        "description": "Card expiration date (format = yymm). If passed, the card expiration date is not calculated using the \"Card expiration (# of months)\" program parameter.\n",
        "example": "2803"
      },
      "IssuingDate": {
        "type": "string",
        "description": "Date/time when card was issued in RFC3339 format, i.e., 2019-07-03T17:23:18Z",
        "example": "2019-07-03T17:23:18Z"
      },
      "OrgID": {
        "type": "string",
        "description": "Organization/tenant ID",
        "example": "TN-f878e4a1-2879-48ba-be16-821e73ac98db"
      },
      "PAN": {
        "type": "string",
        "description": "Card embossed Primary Account Number (PAN).\n\n**Note:** The PAN shown here is a fictional example used for documentation purposes. It does not represent a real card number.\n",
        "example": "123456******7890"
      },
      "PasswordUpdated": {
        "type": "boolean",
        "description": "Has password been updated?"
      },
      "PrintedName": {
        "type": "string",
        "minLength": 2,
        "maxLength": 26,
        "example": "Chester Fields",
        "description": "Printed/embossed card name.\n\nCurrently, you have 3 ways to populate this field:\n   \n   1. During account creation via the `application.applicant.personal.social_name` field.\n   2. During account creation via the `application.applicant.personal.name` field when the field in #1 is not set.\n   3. Passing the `printed_name` field during card creation, updating a card, or when reissuing a card. This takes priority over #1 and #2.\n\nNo letters with accents, numbers, or special characters - only letters (a-z|A-Z) and space, as specified in the <a href=\"https://emvlab.org/emvtags/show/t5F20/\" target=\"_blank\">ISO EMV tag 5F20</a> for cardholder name.\n\n**REQUIRED** for an `UNNUMBERED` card (Card created without PIN or PAN that issuer defines at some point in the future.)\n"
      },
      "ServiceCode": {
        "type": "string",
        "description": "A 3 digit value, not to be confused with the CVV. Each number in the service code has a well-defined meaning, known to the card networks and other components of the interchange networks. The service code's purpose is to tell merchant terminals and acquiring networks about usage restrictions the issuer has placed on the card.\n\nIf passed, a new random service code value is not generated, and the passed value is used instead.\n",
        "minLength": 3,
        "maxLength": 3
      },
      "ValidUntil": {
        "type": "string",
        "description": "Card validation date in UTC time (format:yyyy-MM-ddThh:mm:ssZ). For `TEMPORARY` virtual cards, which have a limited time frame, typically 24 hours (default), or according to the program parameter for this, which is why the date/time here is more granular than `expiration_date`.  \n\nFor more information, refer to [Configuring temporary cards](https://developers.pismo.io/pismo-docs/docs/cards-overview-1#configuring-temporary-cards).\n",
        "example": "2021-07-03T17:23:18Z"
      }
    },
    "securitySchemes": {
      "BearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "description": "Account token - an access token encoded with a Pismo account ID. Tokens can expire quickly, which can result in an \"Unauthorized\" error.",
        "bearerFormat": "JWT"
      }
    },
    "responses": {
      "401Unauthorized": {
        "description": "Access token is missing or invalid"
      },
      "404NotFound": {
        "description": "The specified resource was not found"
      },
      "500InternalServer": {
        "description": "Internal server error"
      }
    }
  },
  "paths": {
    "/pcicards/v2/pcicards/info/{cardId}": {
      "get": {
        "operationId": "get-v2-card-info",
        "summary": "Get card PCI information",
        "description": "Gets sensitive PCI (Payment Card Industry) card data.\n\nCalling this endpoint could change the status of `TEMPORARY` cards. For more information, refer to [Configuring temporary cards](https://developers.pismo.io/pismo-docs/docs/cards-overview-1#configuring-temporary-cards) in the [Cards management](https://developers.pismo.io/pismo-docs/docs/cards-overview-1) guide.\n\n**Note:** This is a PCI endpoint, use the https://gw-pci.pismolabs.io environment.\n",
        "tags": [
          "PCI"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/cardId"
          }
        ],
        "responses": {
          "200": {
            "description": "PCI sensitive card data response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CardPCIInfoResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServer"
          }
        }
      }
    }
  }
}
```