---
schema_version: "1"
id: 06a97f0c578bfeec0fe4eed7d44ce3c32c01054ee6728b028b296a97c3a88d3d
title: Maintenance Response Codes
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/commerce-cloud/commerce-api/guides/response-handling.md
canonical_url: https://developer.salesforce.com/docs/commerce/pwa-kit-managed-runtime/guide/response-handling.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 441000c629f1ab1f0b9ce66234126aa20ed71ec8ae3a5a0693345a3321eb50fe
products:
  - Composable Storefront
  - Salesforce APIs
---
# Maintenance Response Codes

When your B2C Commerce instance is updated as part of a system deployment, or you set the associated site's Site Status to Maintenance, B2C Commerce API returns a maintenance HTTP response.

## System Maintenance

This includes system-wide updates, such as a B2C Commerce release or database upgrade. This status is typically set by B2C Commerce. For additional information, refer to the [B2C Commerce Deployment Schedule.](https://help.salesforce.com/s/articleView?id=commerce.b2c_deploy_schedule_24.htm&type=5)

Additional HTTP response header:

```text
sfdc_maintenance: system
```

Example of the error response body:

```json
{
  "type": "https://api.commercecloud.salesforce.com/documentation/error/v1/errors/system-under-maintenance",
  "title": "System Under Maintenance",
  "detail": "The request could not be processed as the system is currently under maintenance."
}
```

## Site Maintenance

When the Site Status of a B2C Commerce Site is set to Maintenance in Business Manager's Manage Sites panel, an HTTP 503 response is returned with an additional HTTP response header:

```text
sfdc_maintenance: site
```

Example of the error response body:

```json
{
  "type": "https://api.commercecloud.salesforce.com/documentation/error/v1/errors/site-under-maintenance",
  "title": "Site Under Maintenance",
  "detail": "The request could not be processed as the site is currently under maintenance."
}
```