Sign in

v1

latestOpenAPI 3.1.0Copyright Pismo2026-07-247702,7523.1 MB
PCI

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 in the Cards management guide.

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

get/pcicards/v2/pcicards/info/{cardId}

Path parameters

cardIdstring required

Pismo card ID

Response

PCI sensitive card data response

org_idstring

Organization ID

card_idinteger

ID of card to create relationship for

service_codestring

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.

If passed, a new random service code value is not generated, and the passed value is used instead.

correlation_idstring

The Correlation identifier field is used to link related API requests and events. The CID can help the Pismo engineering team track everything related to a call. If not passed, a random one is generated. You can find the CID in the response header.

account_idinteger

Account ID

type'PLASTIC' | 'VIRTUAL' | 'RECURRING' | 'TEMPORARY'

Card type

printed_namestring

Printed name on physical card

valid_untilstring

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.

For more information, refer to Configuring temporary cards.

expiration_datestring

Card expiration date (format = yymm). If passed, the card expiration date is not calculated using the "Card expiration (# of months)" program parameter.

card_numberstring

Card embossed Primary Account Number (PAN).

Note: The PAN shown here is a fictional example used for documentation purposes. It does not represent a real card number.

issuing_datestring

Date/time when card was issued in RFC3339 format, i.e., 2019-07-03T17:23:18Z

cvvstring

Card Verification Code (CVV) (the three numbers behind the card).

cvv_next_rotation_datestring date-time

For virtual cards. Card CVV2/CVC2 next rotation in UTC date/time - format:yyyy-MM-ddThh:mm:ssZ

cvv_rotation_interval_hoursinteger

<b>REQUIRED</b> for a virtual card. Virtual card CVV rotation interval in hours.

To force a rotation manually, call the Rotate virtual card CVV endpoint.

If 0 is passed, the CVV will NOT be rotated.

password_updatedboolean

Has password been updated?

Example response

{
  "org_id": "TN-cc8f8b89-233a-4582-9f36-63ee85278d6d",
  "card_id": 6743052,
  "correlation_id": "c737895c-8159-4c0c-a92a-a4f8600bff37",
  "account_id": 6912345,
  "type": "PLASTIC",
  "printed_name": "Sarah Toga",
  "valid_until": "2021-07-03T17:23:18Z",
  "expiration_date": "2803",
  "card_number": "123456******7890",
  "issuing_date": "2019-07-03T17:23:18Z",
  "cvv": "564",
  "cvv_rotation_interval_hours": 24
}