Retrieve the Availability Status of a Marketing Cloud Engagement Account

You can use the GetSystemStatus API call to retrieve the status of SOAP API.

Use this call in exception-handling circumstance, NOT prior to every API call. New SOAP faults provide more information on application issues resulting in failed logins.

Take the following actions based on the availability status:

  • If the GetSystemStatus call returns OK, no action is required.
  • If the GetSystemStatus call returns InMaintenance, place your application into a queuing mode and periodically make the GetSystemStatus call until the status returns to OK.
  • If the GetSystemStatus call returns UnplannedOutage, place your application into a queuing mode, contact Salesforce Customer Support, and periodically make the GetSystemStatus call until the status returns to OK.

Use the sample code below as a model to set up your own API call. The code uses the GetSystemStatus call, which returns one of the following three result messages:

  • OK: All systems are available.
  • InMaintenance: Some systems are undergoing planned maintenance.
  • UnplannedOutage: Some systems are experiencing an unplanned outage.

The SystemStatusResult object contains the applicable message.

To properly understand and act upon the system status, your environment must include the following elements:

Your application must include a global status container. The value of this container allows your application to change code paths to ensure all messages are stored while waiting for the status to return to OK. If the global status container contains an InMaintenance or UnplannedOutage status, be sure to wait for the scheduled status call (described below) to update the global status container to the OK status.

Your application must include a scheduled status-checking component that can respond to error situations and update the global status container if the status is different. We recommend that you execute the GetCurrentStatus call every 10 minutes. Don't run the call prior to every API call or at an interval less than 10 minutes.

Your application must execute the GetSystemStatus call when SOAP exceptions occur in your application. If the GetSystemStatus call returns anything other than OK, the API updates the global status container.