Get all releases | Documentation

{
  "sys": {
    "type": "Array"
  },
  "limit": 0,
  "total": 0,
  "items": [
    {
      "sys": {
        "type": "Release",
        "space": {
          "sys": {
            "type": "Link",
            "linkType": "Space",
            "id": "yadj1kx9rmg0"
          }
        },
        "environment": {
          "sys": {
            "type": "Link",
            "linkType": "Environment",
            "id": "staging"
          }
        },
        "status": "",
        "version": 0,
        "archivedAt": "2020-01-01T13:00:00.000Z",
        "archivedBy": {
          "sys": {
            "type": "Link",
            "linkType": "User",
            "id": "7BslKh9TdKGOK41VmLDjFZ"
          }
        },
        "createdAt": "2025-11-04T09:58:58.000Z",
        "createdBy": {
          "sys": {
            "type": "Link",
            "linkType": "User",
            "id": "7BslKh9TdKGOK41VmLDjFZ"
          }
        },
        "updatedAt": "2025-11-04T09:58:58.000Z",
        "updatedBy": {
          "sys": {
            "type": "Link",
            "linkType": "User",
            "id": "7BslKh9TdKGOK41VmLDjFZ"
          }
        }
      },
      "title": "",
      "entities": [
        {
          "sys": {
            "type": "Array"
          },
          "items": [
            {
              "id": "",
              "type": "Link",
              "linkType": ""
            }
          ]
        }
      ]
    }
  ]
}

Returns releases for the environment, cursor-paginated. Filter by ID, creator, status, entity membership, and title[match].

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

space_idstringRequired

ID of the space in form of a string

environment_idstringRequired

ID of the environment in form of a string

Query parameters

sys.schemaVersionenumOptional

Schema version to filter releases. Use 'Release.v2' for timeline releases format.

Allowed values:

Response headers

Content-Typestring

Content-Type

Response

OK - Request successful

$	curl -G https://api.contentful.com/spaces/yadj1kx9rmg0/environments/staging/releases \
>	-H "Authorization: Bearer <token>" \
>	-d sys.schemaVersion=Release.v2