# Request Status
source: https://developer.mastercard.com/payment-account-management/documentation/api-overview/request-status/index.md

## Request Status {#request-status}

The [Request Status API](https://developer.mastercard.com/payment-account-management/documentation/api-reference/index.md) call is to provide the customer with the status of their request ids and whether it updated the ABU, Token Vault, or PAR Vault depending on the reason code.
Tip:   

* You should wait at least 60 seconds before submitting the `requestStatus` call. It is recommended that the requestor send either a single Request ID in the `requestStatus` call (after waiting at least 60 seconds), or an array of up to 100 Request IDs at the end of the day.
* The statuses are available for 28 days, so the requestor can check the status anytime within those 28 days.
* All Request IDs submitted should be unique to maintain the integrity of the request status. Request IDs must be alphanumeric characters without special characters (such as @!#_%{}). An example of an appropriate Request ID would be `replacement12345`.

Following an Update, Close, Add, or Override For Delete API request, the caller may use the `requestStatus` API to determine if the operation has been applied to each Mastercard system. The status of each applicable Mastercard system will be shown in the `requestStatus` response.
Note: The response to the /addAccount, /closeAccount, /overrideForDeleteAccount, and the /updateAccount APIs only acknowledges that the request has been received successfully by PAM API. It does not provide information on whether the updates have been applied in ABU, MDES Vault, or PAR Vault. Customers should use the `requestStatus` call to get that additional information.

#### Request Status Response Example - Success {#request-status-response-example---success}

* JSON

```JSON
{
  "statuses": [
    {
      "requestId": "123456",
      "services": [
        {
          "serviceName": "APPLICATION_BILLING_UPDATER",
          "status": "SUCCESS",
        },
        {
          "serviceName": "PAN_TOKEN_MAPPING",
          "status": "SUCCESS",
        },
        {
          "serviceName": "PAN_PAR_MAPPING",
          "status": "SUCCESS",
        }
      ]
    }
  ]
}
```

Note: The `Success` response from MDES in reference to the status of the previous /updateAccount API call only denotes that the request was successfully received by MDES. It does not provide an update on the tokens updated.

#### Request Status Response Example -- ABU Success, Token Vault Failure, and PAR Vault Failure {#request-status-response-example--abu-success-token-vault-failure-and-par-vault-failure}

* JSON

```JSON
{
  "statuses": [
    {
      "requestId": "227896",
      "services": [
        {
          "serviceName": "APPLICATION_BILLING_UPDATER",
          "status": "SUCCESS",
        },
        {
          "serviceName": "PAN_TOKEN_MAPPING",
          "status": "FAILURE",
          "additionalInformation": 201,
        },
        {
          "serviceName": "PAN_PAR_MAPPING",
          "status": "FAILURE",
          "additionalInformation": 302
        }
      ]
    }
  ]
}

```

Note:   

* If ABU, Token Vault, or PAR Vault doesn't consume a specific type of request, no response from that particular system will be available in the [**requestStatus**](https://developer.mastercard.com/payment-account-management/documentation/api-reference/index.md#request-status) response.
* If a [**requestStatus**](https://developer.mastercard.com/payment-account-management/documentation/api-reference/index.md#request-status) call is made with a `requestId` which is not in our system because no previous account update calls were made using the `requestId`, the [**requestStatus**](https://developer.mastercard.com/payment-account-management/documentation/api-reference/index.md#request-status) response will not include a status response from any of the systems.

#### Request Status Response Example -- ABU Success, Token Vault Doesn't Consume, and PAR Vault Failure {#request-status-response-example--abu-success-token-vault-doesnt-consume-and-par-vault-failure}

* JSON

```JSON
{
  "statuses": [
    {
      "requestId": "327896",
      "services": [
        {
          "serviceName": "APPLICATION_BILLING_UPDATER",
          "status": "SUCCESS",
        },
        {
          "serviceName": "PAN_PAR_MAPPING",
          "status": "FAILURE",
          "additionalInformation": 302
        }
      ]
    }
  ]
}
```