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.

HTTP method: GET

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

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

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"
}

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

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"
    }
}

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

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"
}