---
title: "Account Update Status"
method: POST
path: "/updater/status"
tags: ["Updater"]
---

# Account Update Status

`POST /updater/status`

This function is used to request a status update to a previous [Account Update](/apis/payments-platform-rest/openapi/updater/updaterrequest) request for a set of tokens.

**Integration Methods:**
- Host Direct

See the [Integration Methods](/guides/quickstart#integration-methods) and [URLs Section](/guides/quickstart#urls) sections of the Development Quick Start guide for details regarding each processing option.

## Headers

- `InterfaceVersion` string, required
- `InterfaceName` string, required
- `CompanyName` string, required
- `AccessToken` string, uuid, required

## Request body

- object
  - `dateTime` string, ISO 8601, required — The date and time in ISO 8601 format including the timezone offset (yyyy-mm-ddThh:mm:ss.nnn+hh:mm). Must be sent as the local date/time of the merchant. For example, a request processed at a merchant in the Pacific time zone at 9:18am on April 15th 2021 would be sent as 2021-04-15T09:18:23.283-07:00
  - `updaterRequestId` string, uuid, required — Updater Request ID. Returned in the response to the [Account Update](/apis/payments-platform-rest/openapi/updater/updaterrequest) API request. Sent in the [Account Update Status](/apis/payments-platform-rest/openapi/updater/updaterstatus) request when checking on the status of a previous updater request.

## Response `200`

Request was processed

- object
  - `result` object[]
    - `cards` object[] — Array of card tokens
      - `token` string — The token representing the card account number for which you are requesting an update.
      - `status` 'A' | 'B' | 'C' | 'D' | 'E' | 'F' | 'H' | 'O' | 'T' | 'U' — The status of the card update request. | Value | Description | | ----- | ------------------------------------------------------------- | | A | New account number and/or new expiration date. | | B | New expiration date, same account number. | | C | Account is marked as closed. | | D | Contact cardholder for updated information. | | E | No updates were found but the account is valid. | | F | No match for the data provided. Participating BIN/ issuer. | | H | No match for the data provided. Non-participating BIN/issuer. | | O | Cardholder opted out from service. | | T | Token not found / Invalid | | U | Unknown error |
      - `expirationDate` string — The card's expiration date in MMYY format.
      - `newExpirationDate` string — The card's updated expiration date in MMYY format.
      - `newToken` string — The token representing the new card number if the card has been replaced.
    - `dateTime` string, ISO 8601 — The date and time in ISO 8601 format including the timezone offset (yyyy-mm-ddThh:mm:ss.nnn+hh:mm). Must be sent as the local date/time of the merchant. For example, a request processed at a merchant in the Pacific time zone at 9:18am on April 15th 2021 would be sent as 2021-04-15T09:18:23.283-07:00
    - `merchant` MerchantResponse
      - `mid` number — The merchant ID associated with the merchant account.
      - `name` string — The merchant’s business name as configured with Shift4.
    - `server` Server
      - `name` string — The name of the server that processed the request.
    - `updaterRequestId` string, uuid — Updater Request ID. Returned in the response to the [Account Update](/apis/payments-platform-rest/openapi/updater/updaterrequest) API request. Sent in the [Account Update Status](/apis/payments-platform-rest/openapi/updater/updaterstatus) request when checking on the status of a previous updater request.
    - `updaterStatus` 'P' | 'C' — The status of the card update request. | Value | Description | Details | | ----- | ------------|----------------------------------------------- | | P | Pending | Data is not ready yet, please try again later. | | C | Completed | Data is completed and sent in cards array. |

## Other responses

- `400` — Error
- `504` — Timeout

---

[API](https://skmtc.dev/shift4/apis/shift4-payment-api.md) · [All operations](https://skmtc.dev/shift4/apis/shift4-payment-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/shift4/shift4-payment-api/revisions/2f85c87cc9e5/schema)