---
title: "List releases"
method: GET
path: "/release"
tags: ["Release"]
---

# List releases

`GET /release`

List all releases within an application

## Query parameters

- `offset` integer
- `limit` integer
- `application_id` string, required

## Response `200`

The list of releases matching the query.

- ReleaseListResponse
  - `paging` object, required
    - `total` integer, required — The total number of results matching the query.
    - `offset` integer, required — The starting point for pagination. Defaults to 0 if not provided.
    - `limit` integer, required — The maximum number of results to return per page. The maximum allowed value is 200.
  - `results` Release[], required
    - `id` integer, required — A system-wide unique ID for the release.
    - `semver` string, required — A version identifier following Semantic Versioning (SemVer) conventions."
    - `buildId` integer, required — The ID of the build to be released.
    - `status` 'active' | 'pending' | 'deprecated' | 'failed' | 'unstable', required — The status of the release.
    - `asset` Asset, required
      - `id` integer, required — The unique ID for the asset.
      - `buildId` integer, required — The unique ID of the build this asset belongs to.
      - `type` string, required — A string identifying the asset type.
      - `url` string, required — A URL that locates or provides access to the asset.
      - `metadata` string, required — Arbitrary data providing additional context for the asset.
    - `created_at` string, date-time, required — The timestamp when the entity was created.
    - `updated_at` string, date-time, required — The timestamp when the entity was created.

## Other responses

- `4XX` — Client error responses due to invalid input or missing parameters.
- `5XX` — Server error responses indicating an issue on the API side.

---

[API](https://skmtc.dev/nullplatform/apis/nullplatform-api.md) · [All operations](https://skmtc.dev/nullplatform/apis/nullplatform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nullplatform/nullplatform-api/revisions/1c4ea154b159/schema)