Deployments

GET Get bundles for a storefront.

GET /organizations/{organizationId}/storefronts/{storefrontId}/bundles

Operation ID: getBundlesForStorefront. Security: AmOAuth2 (sfcc.storefront.deployments, sfcc.storefront.deployments.rw).

Retrieves a paginated list of bundles uploaded to the specified storefront.

Parameters

  • organizationId (path, OrganizationId, required) An identifier for the Salesforce Commerce Cloud organization the request is being made by. It consists of a prefix 'f_ecom_' followed by a 4-character realm identifier and a 3-character instance type identifier.

    Example

    f_ecom_zzxy_prd
  • storefrontId (path, string, required) The storefront identifier. Must consist only of lowercase letters, numbers, and hyphens, with no leading or trailing hyphens.
    Minimum length: 1. Maximum length: 20. Pattern: ^[a-z0-9]+(?:-+[a-z0-9]+)*$. Example: my-storefront.
  • limit (query, integer (int32)) Number of records to retrieve per request. Must be between 1 (minimum) and 200 (maximum). Defaults to 25.
    Default: 25. Minimum: 1. Maximum: 200.
  • offset (query, integer (int32)) Used to retrieve the results based on a particular resource offset.
    Default: 0. Minimum: 0.

Responses

  • 200 List of bundles successfully retrieved.

    Media type: application/json. Schema: BundleResult.

    Example: BundleListSuccess Successful bundle list result

    Example of a successful response returning a paginated list of bundles for a storefront.

    {
      "limit": 25,
      "offset": 0,
      "total": 3,
      "data": [
        {
          "bundleId": 170,
          "description": "my bundle",
          "status": "ok",
          "lifecycleStatus": "active",
          "createdBy": "dev@example.com",
          "creationDate": "2026-04-08T21:47:28.188965Z",
          "lastModified": "2026-04-08T21:47:31.307595Z",
          "type": "ssr",
          "ssrParameters": {
            "runtime": "24.x",
            "runtimeDescription": "NodeJS 24.x",
            "envBasePath": "ca"
          },
          "inUseBy": [
            "production"
          ],
          "streamingEnabled": true
        },
        {
          "bundleId": 169,
          "description": "previous release",
          "status": "ok",
          "lifecycleStatus": "active",
          "createdBy": "dev@example.com",
          "creationDate": "2026-04-07T15:30:00.000000Z",
          "lastModified": "2026-04-07T15:30:05.000000Z",
          "type": "ssr",
          "ssrParameters": {
            "runtime": "24.x",
            "runtimeDescription": "NodeJS 24.x",
            "envBasePath": "ca"
          },
          "inUseBy": [],
          "streamingEnabled": false
        }
      ]
    }
  • 401 Your access token is invalid or expired and can’t be used to identify a user.

    Media type: application/problem+json. Schema: ErrorResponse.

    Example: UnauthorizedExample

    {
      "type": "https://api.commercecloud.salesforce.com/documentation/error/v1/errors/unauthorized",
      "title": "Unauthorized",
      "detail": "Unauthorized request"
    }
  • 403 Forbidden. Your access token is valid, but you don’t have the required permissions to access the resource.

    Media type: application/problem+json. Schema: ErrorResponse.

    Example: ForbiddenExample

    {
      "type": "https://api.commercecloud.salesforce.com/documentation/error/v1/errors/forbidden",
      "title": "Forbidden",
      "detail": "Access to requested resource forbidden"
    }