---
title: "Returns the status and metadata of a specific release."
method: GET
path: "/releases/{releaseId}"
tags: ["components"]
---

# Returns the status and metadata of a specific release.

`GET /releases/{releaseId}`

## Request

- Base URL: `https://marketplace-api.mendix.com/v1`
- URL: `https://marketplace-api.mendix.com/v1/releases/{releaseId}`
- Auth: API key in header `Authorization`

Retrieves the current status and metadata of a specific release. This allows Marketplace component publishers to monitor the release status progress and make informed decisions about next steps.

**Authorization:** The user must have access to view the release.

**Status Values:**
- `Draft`: The release is in `Draft` state and hasn't been submitted for review or published yet.
- `InReview`: The release is under review.
  - For private components, it is ready to be reviewed by a Mendix Admin if private approval is enabled for the related company.
  - For public components, it undergoes security scanning and review by the security system.
- `Declined`: The release is declined.
  - For private components, the release is declined by a Mendix Admin.
  - For public components, the security checks did not pass for the release.
- `Published`: The release is published to the Marketplace and ready to be consumed.

## Path parameters

- `releaseId` string, uuid, required

## Response `200`

successful operation

- ReleaseStatus: The status and metadata of a specific release. This schema is used to track the lifecycle state of a release from draft to publication.
  - `name` string, required: This is the name of the release of the component.
  - `status` 'Draft' | 'InReview' | 'Declined' | 'Published', required: The current status of the release. Possible values are: `Draft` (being prepared), `InReview` (submitted for review), `Declined` (reviewed and declined), `Published` (approved and publicly available).
  - `releaseId` string, uuid, required: This is the UUID of the release.
  - `versionNumber` string, required: This is the version number of the release. The format is `major.minor.patch` (for example, `2.0.0`).
  - `minSupportedMendixVersion` string, required: This is the Studio Pro version selected during the onboarding. This means that any Studio Pro version equal to or greater than this version is compatible with the latest release of the component.
  - `publicationDate` string, yyyy-MM-ddTHH-mm-ssZ: The date when the release was published. This field is only present for releases with the `Published` status.
  - `releaseNotes` string: The release notes for this release.

## Other responses

- `401`: No usable authentication credentials were found. The error message gives additional information.
- `404`: The required item could not be found. The error message provides additional information.
- `500`: An error occurred during the processing of the request. The error message provides additional information.

---

[API](https://skmtc.dev/mendix/apis/publish-api.md) - [All operations](https://skmtc.dev/mendix/apis/publish-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mendix/apis/publish-api/revisions/2cf1d323f0b8?raw)