GetSingleCard

The "GetSingleCard" endpoint allows customers to retrieve the full details of a specific card using the ID of the card record, including its masked/encrypted PAN, card scheme, issuance status, and channel-enablement flags (ATM, POS, Web).

PUT /api/Card/v{{version}}/Interswitch/GetSingleCard

To retrieve a card's details, you need to provide the cardId of the card record as a query parameter. A successful request returns the card's full profile under data, including identifiers (serialNumber, bankCode), card metadata (cardType, cardScheme, cardProfileId), lifecycle dates (issuedDate, expiryDate, dateCreated), its current status, and which channels it's enabled for.

This endpoint streamlines card lookups by returning a single record's full detail in one call, useful anywhere you need to confirm a card's current state before acting on it.

Headers

Name	Value
Content-Type*	application/json
Request-Reference	unique_string

Query Params

Name	Description
cardId	The ID of the card record to retrieve details for.

Here is an example request and response with a sample payload sent to the endpoint in Curl format.

Sample Request

curl --location -g --request PUT '{{baseUrl}}/api/Card/v{{version}}/Interswitch/GetSingleCard?cardId=33C21285-3704-4519-AB4D-CB3CC2210AD1' \
--header 'Content-Type: application/json'

Response: 200

{
  "status": true,
  "message": "Operation Successful",
  "data": {
    "batchNo": null,
    "maskedPan": "506136*********3971",
    "encrptedPan": "9SwhhFsBSsLF2wPx5G8mOnaROaL7Zz1W+IqHjsOq0kA=",
    "hashedPan": "3FC26AA400EB45B70E786230339D9CB4B03FA0605ADDDAA8F3D99CAF8564AF91",
    "accountNumber": null,
    "nameOnCard": null,
    "clearPan": null,
    "serialNumber": "97523971",
    "bankCode": "000003",
    "cardGenerationRequestId": "00000000-0000-0000-0000-000000000000",
    "expiryDate": "2023-03-26T00:00:00",
    "requestDate": null,
    "issuedDate": "2024-11-18T12:12:09.2566667",
    "issuanceStatus": "Issued",
    "cardProfileId": "88e146b6-7b8e-41e4-9c04-1ef78fc859a0",
    "cardType": "Default",
    "cardScheme": "MasterCard",
    "status": "Active",
    "isATMEnabled": true,
    "isPOSEnabled": true,
    "isWebEnabled": true,
    "cardFileLink": null,
    "id": "33c21285-3704-4519-ab4d-cb3cc2210ad1",
    "dateCreated": "2023-03-26T21:04:36.0466667",
    "dateLastModified": null
  }
}