List a Project's Releases

GET /api/0/projects/{organization_id_or_slug}/{project_id_or_slug}/releases/

Retrieve a list of releases for a given project.

Path Parameters

organization_id_or_slug (string)
REQUIRED

The ID or slug of the organization the resource belongs to.

project_id_or_slug (string)
REQUIRED

The ID or slug of the project the resource belongs to.

Query Parameters:

environment (array(string))

The name of environments to filter by.

query (string)

Case-insensitive substring match against the release version.

cursor (string)

A pointer to the last object fetched and its sort order; used to retrieve the next or previous results.

Scopes

<auth_token> requires one of the following scopes:
  • org:ci
  • project:admin
  • project:read
  • project:releases
  • project:write
Copied
curl https://sentry.io/api/0/projects/{organization_id_or_slug}/{project_id_or_slug}/releases/ \
 -H 'Authorization: Bearer <auth_token>'
RESPONSESCHEMA
Copied
[
  {
    "id": 1,
    "version": "frontend@1.0.0",
    "shortVersion": "frontend@1.0.0",
    "status": "open",
    "versionInfo": {
      "package": "frontend",
      "version": {
        "raw": "1.0.0",
        "major": 1,
        "minor": 0,
        "patch": 0,
        "pre": null,
        "buildCode": null,
        "components": 3
      },
      "description": "1.0.0",
      "buildHash": null
    },
    "ref": null,
    "url": null,
    "dateReleased": null,
    "dateCreated": "2024-01-01T00:00:00Z",
    "data": {},
    "newGroups": 0,
    "owner": null,
    "commitCount": 0,
    "lastCommit": null,
    "deployCount": 0,
    "lastDeploy": null,
    "authors": [],
    "projects": [
      {
        "id": 1,
        "slug": "sentry",
        "name": "sentry",
        "newGroups": 0,
        "platform": "javascript",
        "platforms": [
          "javascript"
        ],
        "hasHealthData": false
      }
    ],
    "firstEvent": null,
    "lastEvent": null,
    "currentProjectMeta": {},
    "userAgent": null
  }
]
Was this helpful?