Card Details — Get by ID or Token

Returns one card’s full details when either cardId or token is provided. At least one must be present; providing both is allowed.

POST{gateway}/pcs/api/v1/cards/details

Payload

Attribute	Type	Required	Description
cardId	Integer	Conditional	Unique ID of the card. Required if `token` not provided.
token	Integer	Conditional	Card token (PAN surrogate). Required if `cardId` not provided.

Request Example

{
  "cardId": 17
}

Response

Attribute	Type	Description
data.id	Integer	Card ID.
data.userId	Integer	Owner (user) ID.
data.cardIssuerConfigId	Integer	Issuer configuration reference.
data.userProfile	Object	Basic profile of the cardholder.
data.userProfile.id	Integer	Profile ID.
data.userProfile.pronounTitle	String	Title (e.g., Mr, Ms).
data.userProfile.firstName	String	First name.
data.userProfile.lastName	String	Last name.
data.userProfile.email	String	Email address.
data.userProfile.countryCode	String	Dial code (e.g., 92).
data.userProfile.phone	String	Phone number.
data.userProfile.language	String	Preferred language.
data._3dSecure	Object	3DS configuration for the card.
data._3dSecure.id	Integer	3DS record ID.
data._3dSecure.configId	Integer	3DS config reference.
data._3dSecure.status	Boolean	Whether 3DS is enabled.
data.account	Object	Linked funding account details.
data.account.id	Integer	Internal record ID.
data.account.accountId	Integer	Account ID.
data.account.userId	Integer	Account owner user ID.
data.account.accountType	String	Account type (e.g., DIGITAL).
data.account.currencyCode	String	Account currency (e.g., AED).
data.account.accountTitle	String	Account title/name.
data.account.accountNumber	String	Account number.
data.account.iban	String	IBAN of the account.
data.cardTier	Object	Card tier (product) flags.
data.cardTier.id	Integer	Card tier ID.
data.cardTier.enableFraudRules	Boolean	Fraud rules enabled.
data.cardTier.enableLimits	Boolean	Spending limits enabled.
data.activation	Object	Activation status details.
data.activation.id	Integer	Activation record ID.
data.activation.activationMode	String	Activation mode (e.g., APP_ACTIVATION).
data.activation.activationDate	String (ISO 8601)	Activation date-time.
data.activation.status	Boolean	Whether card is active.
data.manufacturing	Object	Manufacturing lifecycle details.
data.manufacturing.id	Integer	Manufacturing record ID.
data.manufacturing.configId	Integer	Manufacturer config ref.
data.manufacturing.estimatedManufacturingTime	String (ISO 8601)	Estimated manufacturing time.
data.manufacturing.status	String	Manufacturing status (e.g., MANUFACTURED).
data.delivery	Object	Delivery lifecycle details.
data.delivery.id	Integer	Delivery record ID.
data.delivery.configId	Integer	Delivery partner config ref.
data.delivery.status	String	Delivery status (e.g., DELIVERED).
data.delivery.estimatedDeliveryTime	String (ISO 8601)	Estimated delivery time.
data.delivery.address	Object	Delivery address.
data.paymentCardType	String	DEBIT / CREDIT / PREPAID.
data.cardNetwork	String	Network (e.g., MASTERCARD).
data.cardType	String	PHYSICAL / VIRTUAL.
data.billingCurrency	String	Billing currency (e.g., AED).
data.embossName	String	Embossed name on card.
data.lastFourDigits	String	Last four digits of PAN.
data.token	Integer	Card token.
data.tokenFlags	String	Token flag bitmask.
data.pinSet	Boolean	Whether PIN is set.
data.status	String	Card status (e.g., ACTIVE).
data.cardText	String	Human-readable status text.
data.maxPurchaseLimit	Number	Max purchase limit.
data.remarks	String	Operational remarks.
data.statusReason	String	Status reason (if any).
data.cardCategory	String	Card category (e.g., STANDARD).
data.consumerType	String	CONSUMER / CORPORATE.
data.reportedCards	Array	Related reports (e.g., lost/stolen).
data.processedAtThirdParty	Boolean	Whether processed at third party.
data.apiCallUniqueIdentifier	String (UUID)	API call trace identifier.
data.createdAt	String (ISO 8601)	Record creation timestamp.
data.updatedAt	String (ISO 8601)	Record update timestamp.
data.cardHolderName	String	Full name of cardholder.
data.cardTokens	Array	Additional tokens (if any).

200 — SUCCESS

{
  "data": {
    "id": 17,
    "userId": 640,
    "cardIssuerConfigId": 1,
    "userProfile": {
      "id": 17,
      "pronounTitle": "Mr",
      "firstName": "Gulraiz",
      "lastName": "Khalil",
      "email": "gulraiz.user@mailinator.com",
      "countryCode": "92",
      "phone": "3075061400",
      "language": "ENGLISH"
    },
    "_3dSecure": { "id": 18, "configId": 9, "status": false },
    "account": {
      "id": 17,
      "accountId": 43,
      "userId": 640,
      "accountType": "DIGITAL",
      "currencyCode": "AED",
      "accountTitle": "GULRAIZ KHALIL",
      "accountNumber": "1000648060000903",
      "iban": "AE470961000648060000903"
    },
    "cardTier": { "id": 1, "enableFraudRules": false, "enableLimits": true },
    "activation": {
      "id": 12,
      "activationMode": "APP_ACTIVATION",
      "activationDate": "2025-01-23T07:35:37.685+00:00",
      "status": true
    },
    "manufacturing": {
      "id": 8,
      "configId": 2,
      "estimatedManufacturingTime": "2025-01-23T12:00:00",
      "status": "MANUFACTURED"
    },
    "delivery": {
      "id": 8,
      "configId": 3,
      "status": "DELIVERED",
      "estimatedDeliveryTime": "2025-01-23T12:00:00",
      "address": {
        "id": 17,
        "country": "Afghanistan",
        "state": "Badakhshan",
        "city": "Ashkāsham",
        "addressLine1": "bjkasdhia",
        "addressLine2": "",
        "type": "MAILING",
        "postalCode": "45000"
      }
    },
    "paymentCardType": "DEBIT",
    "cardNetwork": "MASTERCARD",
    "cardType": "PHYSICAL",
    "billingCurrency": "AED",
    "embossName": "Saad",
    "lastFourDigits": "8595",
    "token": 757129776,
    "tokenFlags": "00010000000000000000000000000000",
    "pinSet": true,
    "status": "ACTIVE",
    "cardText": "Your card is active",
    "maxPurchaseLimit": 100,
    "remarks": "Accepted",
    "statusReason": "",
    "cardCategory": "STANDARD",
    "consumerType": "CONSUMER",
    "reportedCards": [],
    "processedAtThirdParty": true,
    "apiCallUniqueIdentifier": "f9757919-086d-491e-88cd-05fbb2932d07",
    "createdAt": "2025-01-23T07:19:30.147+00:00",
    "updatedAt": "2025-02-06T07:26:45.843+00:00",
    "cardHolderName": "Gulraiz Khalil",
    "cardTokens": []
  }
}

422 — FAILED

{
  "code": 1000,
  "message": "Invalid payload. Please check your request.",
  "type": "INVALID_PAYLOAD",
  "errors": [
    {
      "key": "cardId",
      "reason": "Invalid card ID or token provided."
    }
  ]
}

Set or Update Card PIN Get Card PAN