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 Notfications API.

HTTP method: GET

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

Scenario 1: Get 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 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"
    }
}