---
schema_version: "1"
id: 4b11a963a41367b105dd70049f216a84442c0f8c808a2aefb907149ebb8ae355
title: GetSystemStatus
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/marketing-cloud/guides/mc-apis/getsystemstatus.md
canonical_url: https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/getsystemstatus.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: efbac66b94b9e1d7766a73d8ca11e18601bbf258c31d324f2f15541eb273edde
products:
  - Marketing Cloud Engagement APIs and Programmatic Languages
  - Marketing Cloud
---
# GetSystemStatus

Use the GetSystemStatus method to retrieve the status of your account. Use this method only during exception handling or as the first SOAP API call.

**note:** Don't use this method before every API call or at intervals less than 60 seconds. When troubleshooting, run this method about every 10 minutes.

## Parameters

| Name                   | Data Type           | Description                                          |
| ---------------------- | ------------------- | ---------------------------------------------------- |
| `Options`              | SystemStatusOptions | Optionally specifies more processing options.        |
| `OverallStatus`        | String              | Specifies the overall status of the request.         |
| `OverallStatusMessage` | String              | Specifies the overall status message of the request. |
| `RequestID`            | String              | A unique identifier for the request.                 |

## Output

This method returns an array of SystemStatusResult objects.

If the SystemStatusResult SystemStatus property equals **OK**, no action is required.

If the SystemStatusResult SystemStatus property equals **InMaintenance**, place your application in queue mode and periodically make the GetSystemStatus call until the status returns to OK.

If the SystemStatusResult SystemStatus property equals **UnplannedOutage**, place your application in queue mode and periodically make the GetSystemStatus call until the status returns to OK.

To understand and act on the system status, we recommend that you have these elements in place.

- A global status container in your application. This container can allow your application to change code paths to ensure that all messages are stored while waiting for the status to return to OK. If the global status container contains an InMaintenance or UnplannedOutage status, wait for the scheduled status checking component to update the global status container to the OK status.
- A scheduled status checking component in your software, so it can respond to error situations and update the global status container if the status is different.

## Usage

This sample SOAP envelope shows how to retrieve the current system status.

```xml
<?xml version="1.0" encoding="UTF-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"
            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
            xmlns:xsd="http://www.w3.org/2001/XMLSchema"
            xmlns:a="http://schemas.xmlsoap.org/ws/2004/08/addressing">
  <s:Header>
    <a:Action>GetSystemStatus</a:Action>
    <a:To>https://YOUR_SUBDOMAIN.soap.marketingcloudapis.com/Service.asmx</a:To>
    <fueloauth xmlns="http://exacttarget.com">YOUR_ACCESS_TOKEN</fueloauth>
  </s:Header>
  <s:Body>
    <SystemStatusRequestMsg xmlns="http://exacttarget.com/wsdl/partnerAPI">
      <Options />
    </SystemStatusRequestMsg>
  </s:Body>
</s:Envelope>
```

On success, the API returns HTTP `200` response with a SOAP body that resembles this example.

```xml
<?xml version="1.0" encoding="UTF-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"
            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
            xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <s:Body>
    <SystemStatusResponseMsg xmlns="http://exacttarget.com/wsdl/partnerAPI">
      <OverallStatus>OK</OverallStatus>
      <OverallStatusMessage xsi:nil="true"/>
      <RequestID>a1b2c3d4-e5f6-7890-abcd-ef1234567890</RequestID>
      <Results xsi:type="SystemStatusResult">
        <SystemStatus>OK</SystemStatus>
      </Results>
    </SystemStatusResponseMsg>
  </s:Body>
</s:Envelope>
```