SearchCardAccount

The "SearchCardAccount" endpoint allows customers to look up card-account link records in the Card Account data store using any combination of filters

GET /api/Card/v{{version}}/Interswitch/SearchCardAccount

Pass only the field(s) you intend to search by, every query parameter is optional, and the endpoint filters on whatever combination you provide.

MaskedPAN must follow the platform's masking format: the first 6 and last 4 digits of the card, with nine asterisks (*) in between (e.g. 506136*********9443).

To search for card accounts, you can pass any of the supported query parameters AccountNumber, MaskedPAN, Status, CustomerId, StartDate, EndDate, PageNumber, PageSize as needed.

A successful request returns a paginated list of matching card-account records under data, each showing the account-side details (accountNumber, nameOnCard, customerId) alongside the full linked card profile in a nested card object, plus a recordCount showing the total number of matching records.

This endpoint streamlines the process of finding which account a card is linked to (or vice versa), letting you search across account-card links in a single call rather than cross-referencing separate account and card lookups.

Headers

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

Query Params

Name	Description
AccountNumber	The account number to search by. Optional.
MaskedPAN	The card's masked PAN to search by (first 6 and last 4 digits, nine asterisks in between). Optional.
Status	The link status to filter by (e.g. Linked). Optional.
CustomerId	The customer ID to filter by. Optional.
StartDate	The start of the date range to filter by. Optional.
EndDate	The end of the date range to filter by. Optional.
PageNumber	The page number to retrieve. Optional.
PageSize	The number of records to return per page. Optional.

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

Sample Request

curl --location -g '{{baseUrl}}/api/Card/v{{version}}/Interswitch/SearchCardAccount?AccountNumber=1700263070&MaskedPAN=506136*********9443&Status=Linked&CustomerId=10029001&StartDate=2023-03-26&EndDate=2023-03-28&PageNumber=1&PageSize=10' \
--header 'Content-Type: application/json'

Response: 200

{
  "status": true,
  "message": "string",
  "data": {
    "data": [
      {
        "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "dateCreated": "2025-03-31T13:55:54.140Z",
        "dateLastModified": "2025-03-31T13:55:54.140Z",
        "accountNumber": "string",
        "nameOnCard": "string",
        "customerId": "string",
        "cardId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "card": {
          "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "dateCreated": "2025-03-31T13:55:54.140Z",
          "dateLastModified": "2025-03-31T13:55:54.140Z",
          "batchNo": "string",
          "maskedPan": "string",
          "encrptedPan": "string",
          "hashedPan": "string",
          "accountNumber": "string",
          "nameOnCard": "string",
          "serialNumber": "string",
          "expiryDate": "2025-03-31T13:55:54.140Z",
          "requestDate": "2025-03-31T13:55:54.140Z",
          "issuedDate": "2025-03-31T13:55:54.140Z",
          "issuanceStatus": "string",
          "cardProfileId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "cardType": "string",
          "cardScheme": "string",
          "status": "string",
          "isATMEnabled": true,
          "isPOSEnabled": true,
          "isWebEnabled": true,
          "cardFileLink": "string"
        },
        "bankCode": "string",
        "encrptedPan": "string",
        "hashedPan": "string",
        "overrideProductApplicableFee": true,
        "overrideProductApplicableInterest": true,
        "productCode": "string",
        "productName": "string",
        "signatureFileUrl": "string",
        "passportFileUrl": "string",
        "status": "string"
      }
    ],
    "recordCount": 0
  }
}