---
id: release-list
title: "List releases"
description: "List all releases within an application"
sidebar_label: "List releases"
hide_title: true
hide_table_of_contents: true
api: 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
sidebar_class_name: "get api-method"
info_path: docs/api/release
custom_edit_url: null
---

import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint";
import ParamsDetails from "@theme/ParamsDetails";
import RequestSchema from "@theme/RequestSchema";
import StatusCodes from "@theme/StatusCodes";
import OperationTabs from "@theme/OperationTabs";
import TabItem from "@theme/TabItem";
import Heading from "@theme/Heading";

<Heading
  as={"h1"}
  className={"openapi__heading"}
  children={"List releases"}
>
</Heading>

<MethodEndpoint
  method={"get"}
  path={"/release"}
  context={"endpoint"}
>
  
</MethodEndpoint>



List all releases within an application

<Heading
  id={"request"}
  as={"h2"}
  className={"openapi-tabs__heading"}
  children={"Request"}
>
</Heading>

<ParamsDetails
  parameters={[{"in":"query","name":"offset","schema":{"type":"integer","minimum":0,"default":0},"description":"The starting point for pagination. Defaults to 0 if not provided.","example":0},{"in":"query","name":"limit","schema":{"type":"integer"},"description":"The maximum number of results to return per page.","example":30},{"in":"query","name":"application_id","schema":{"type":"string"},"required":true,"description":"The application ID for the releases being listed. Allows up to 10 comma-separated values.","example":"5678,1234"}]}
>
  
</ParamsDetails>

<RequestSchema
  title={"Body"}
  body={undefined}
>
  
</RequestSchema>

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"200":{"description":"The list of releases matching the query.","content":{"application/json":{"schema":{"type":"object","required":["paging","results"],"properties":{"paging":{"type":"object","required":["offset","limit","total"],"properties":{"total":{"type":"integer","description":"The total number of results matching the query.","example":30},"offset":{"type":"integer","minimum":0,"description":"The starting point for pagination. Defaults to 0 if not provided.","example":0},"limit":{"type":"integer","description":"The number of results returned per page. Defaults to 30.","example":30}}},"results":{"type":"array","items":{"type":"object","required":["id","semver","buildId","status","application_id","asset","created_at","updated_at"],"properties":{"id":{"type":"integer","description":"A system-wide unique ID for the release.","example":789},"semver":{"type":"string","description":"A version identifier following Semantic Versioning (SemVer) conventions.\"","example":"1.0.1-rc1","title":"semver"},"buildId":{"type":"integer","description":"The ID of the build to be released.","example":456},"status":{"type":"string","description":"The status of the release.","enum":["active","pending","deprecated","failed","unstable"],"example":"active","title":"release_status"},"asset":{"type":"object","required":["id","buildId","type","url","metadata"],"properties":{"id":{"type":"integer","description":"The unique ID for the asset.","example":123},"buildId":{"type":"integer","description":"The unique ID of the build this asset belongs to.","example":456},"type":{"type":"string","description":"A string identifying the asset type.","example":"docker-image"},"url":{"type":"string","description":"A URL that locates or provides access to the asset.","example":"https://example.com/assets/456"},"metadata":{"type":"string","description":"Arbitrary data providing additional context for the asset."}},"title":"asset"},"created_at":{"type":"string","format":"date-time","description":"The timestamp when the entity was created.","example":"2023-10-01T12:34:56Z","title":"date"},"updated_at":{"type":"string","format":"date-time","description":"The timestamp when the entity was created.","example":"2023-10-01T12:34:56Z","title":"date"}},"title":"release"}}},"title":"releaseListResponse"}}}},"4XX":{"description":"Client error responses due to invalid input or missing parameters.","content":{"application/json":{"schema":{"type":"object","required":["statusCode","error","message"],"properties":{"statusCode":{"type":"integer","description":"HTTP status code representing the specific client error (e.g., 400, 401, 403, 404).","example":400},"code":{"type":"string","description":"A machine-readable error code that categorizes the server failure.","example":"bad_request"},"error":{"type":"string","description":"A brief, human-readable description of the error type (e.g., \"Bad Request\", \"Unauthorized\").","example":"Bad Request"},"message":{"type":"string","description":"Additional details about the error.","example":"The request was malformed or contained invalid parameters."}}}}}},"5XX":{"description":"Server error responses indicating an issue on the API side.","content":{"application/json":{"schema":{"type":"object","required":["statusCode","error","message"],"properties":{"statusCode":{"type":"integer","description":"HTTP status code representing the specific server error (e.g., 500, 502, 503).","example":500},"code":{"type":"string","description":"A machine-readable error code that categorizes the server failure.","example":"internal_server_error"},"error":{"type":"string","description":"A brief, human-readable description of the error type (e.g., \"Internal Server Error\", \"Service Unavailable\").","example":"Internal Server Error"},"message":{"type":"string","description":"Additional details about the error.","example":"An unexpected error occurred. Please try again later."}}}}}}}}
>
  
</StatusCodes>