---
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","maximum":200,"description":"The maximum number of results to return per page. The maximum allowed value is 200.","example":200}}},"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>