Optimization Protection

Retrieve latest card account updates

Use a GET request to retrieve the latest account update information from the most recent card account update inquiry for a specific card account.

Required path parameter field:

The account-identifier value can be obtained from the following two APIs:

Account Updater API: You can use the requestId or responseId as the account-identifier key. These IDs originate from a previously executed Account Updater POST request.
Notifications API: You can use the transactionId as the account-identifier key which originates from the webhook notifications for account updates of registered cards. For more information, refer to Account updater events in the Notifications API.

Retrieve account updates

Get the latest card account updates using the requestId or responseId from the previous POST inquiry response for the specific card account.

HTTP method: GET

Endpoint: /account-updates/{account-identifier}

Response:

Json

{
    "recordUpdateTimestamp": "2024-11-15T01:13:46.256Z",
    "responseId": "89af6487-a14e-4cd8-8821-7f8c35df8a96",
    "requestId": "bd3e8655-081d-4c26-b406-559aaeb934bd",
    "requestStatus": "REGISTERED",
    "response": "SUCCESS",
    "resultsMessage": {
        "oldAccountInformation": {
            "cardNumber": "4111111111111113",
            "expiry": {
                "month": 9,
                "year": 2032
            },
            "cardTypeName": "VISA",
            "accountNumberType": "PAN"
        },
        "newAccountInformation": {
            "cardNumber": "4111111180885260",
            "expiry": {
                "month": 9,
                "year": 2037
            },
            "cardTypeName": "VISA",
            "paymentMethodChanged": false,
            "accountNumberType": "PAN"
        },
        "networkResponse": "A",
        "reason": "Account Update provided for both account number and expiry"
    },
    "subMerchantId": "000000676252"
}

Retrieve account updates using Safetech token

Get the latest card account updates using the requestId or responseId from the previous POST inquiry response for the accountNumberType as SAFETECH_TOKEN.

HTTP method: GET

Endpoint: /account-updates/{account-identifier}

Response:

Json

{
    "recordUpdateTimestamp": "2024-11-18T16:47:41.457Z",
    "responseId": "113194fc-2f07-4ff5-a3c3-85895652c629",
    "requestId": "da887c4b-68b5-4346-b390-2e81afb75223",
    "response": "SUCCESS",
    "resultsMessage": {
        "oldAccountInformation": {
            "cardNumber": "4111111557381113",
            "expiry": {
                "month": 7,
                "year": 2026
            },
            "cardTypeName": "VISA",
            "accountNumberType": "SAFETECH_TOKEN"
        },
        "newAccountInformation": {
            "cardNumber": "4111117039188641",
            "expiry": {
                "month": 7,
                "year": 2031
            },
            "cardTypeName": "VISA",
            "paymentMethodChanged": false,
            "accountNumberType": "SAFETECH_TOKEN"
        },
        "networkResponse": "A",
        "reason": "Account Update provided for both account number and expiry"
    }
}

Retrieve account updates for Discover

Get the latest card account updates for Discover using the requestId or responseId from the previous POST inquiry response for the accountNumberType as PAN.

HTTP method: GET

Endpoint: /account-updates/{account-identifier}

Response:

Json

{
  "recordUpdateTimestamp": "2025-06-24T21:10:01.875Z",
  "responseId": "6147bb3d-d241-42c2-a1bd-9e90ffa8b3f3",
  "requestId": "b801f6a1-9e70-4e1c-a91c-11b2ab01a126",
  "requestStatus": "REGISTERED",
  "response": "SUCCESS",
  "resultsMessage": {
    "oldAccountInformation": {
      "cardNumber": "6011111111111116",
      "expiry": {
        "month": 12,
        "year": 2020
      },
      "cardTypeName": "DISCOVER",
      "accountNumberType": "PAN"
    },
    "newAccountInformation": {
      "cardNumber": "6211111111111114",
      "expiry": {
        "month": 12,
        "year": 2025
      },
      "cardTypeName": "DISCOVER",
      "paymentMethodChanged": false,
      "accountNumberType": "PAN"
    },
    "reasonMessage": "NEW_ACCOUNT_AND_EXPIRY",
    "responseMessage": "Account Update provided for both account number and expiry",
    "networkResponseCode": "A"
  },
  "cardAccountAction": "REGISTER"
}

Retrieve account updates for registered cards

Get the latest card account updates after you recieve webhook-notification for registered cards.

HTTP method: GET

Endpoint: /account-updates/{account-identifier}

Response:

Json

{
  "recordUpdateTimestamp": "2025-09-08T23:08:18.619Z",
  "responseId": "1576617d-1f05-4099-9adb-5df0a1879f14",
  "requestId": "49348e46-dfcb-4feb-898c-966fa2d532d0",
  "requestStatus": "REGISTERED",
  "response": "SUCCESS",
  "resultsMessage": {
    "oldAccountInformation": {
      "cardNumber": "5111111111111113",
      "expiry": {
        "month": 12,
        "year": 2032
      },
      "cardTypeName": "MASTERCARD",
      "accountNumberType": "PAN"
    },
    "newAccountInformation": {
      "cardNumber": "5111111111111112",
      "expiry": {
        "month": 12,
        "year": 2035
      },
      "cardTypeName": "MASTERCARD",
      "accountNumberType": "PAN"
    },
    "reasonMessage": "NEW_ACCOUNT_AND_EXPIRY",
    "responseMessage": "Account Update provided for both account number and expiry",
    "networkResponseCode": "ACCOUNT_UPDATE"
  }
}

Note

oldAccountInformation refers to the card details that were in use directly before the current card. newAccountInformation refers to the details of the card currently in use.