List releases
List all releases for an application with filtering and sorting. Requires releases:read scope.
/applications/{application_id}/releasesAuthorization
bearerAuth API key. Bearer authentication header of the form Bearer <token>, where <token> is your Workspace or Application API key.
In: header
Path Parameters
Application ID.
Query Parameters
Sort by field. version sorts by full semantic version, version_short sorts by core version (major.minor.patch).
"created_at"Value in
- "version"
- "version_short"
- "title"
- "created_at"
Sort direction.
"asc"Value in
- "asc"
- "desc"
Items per page (default varies by endpoint; max 100).
1 <= value <= 10015Search query (max 50 characters). Searches release title, ID (sqid), and version.
length <= 50Filter by label ID or name. Accepts a single value or comma-separated list. Returns 422 if any identifier is invalid.
Filter by platform slugs. Accepts a single slug or comma-separated list. Returns releases containing builds on those platforms. Returns 422 if any slug is invalid. See Platforms for valid platform slugs.
Response Body
application/json
application/json
application/json
application/json
curl -X GET -G "https://example.comapplications/aBc1234/releases" \ --data-urlencode "search=1.2.0" \ --data-urlencode "labels=rc,hotfix" \ --data-urlencode "platforms=android,ios" \ -H "Authorization: Bearer YOUR_API_KEY"{ "message": "Releases retrieved successfully.", "data": [ { "id": "rLs4567", "version": "1.0.0", "version_short": "1.0.0", "version_semantic_major": 1, "version_semantic_minor": 0, "version_semantic_patch": 0, "version_semantic_extra": null, "version_semantic_meta": null, "title": "Initial Release", "labels": [ { "id": "lbl1234", "name": "Production", "description": "Production-ready builds", "color": "#22c55e", "level": "application", "created_at": "2025-06-10T09:15:00.000000Z", "updated_at": "2025-06-15T14:30:00.000000Z" } ], "build_count": 3, "created_at": "2025-06-10T09:15:00.000000Z", "updated_at": "2025-06-15T14:30:00.000000Z" } ], "pagination": { "current_page": 1, "per_page": 10, "total": 42, "last_page": 5, "from": 1, "to": 10 }}{ "message": "Unauthorized"}{ "message": "This action requires 'resource:action' scope."}{ "message": "string"}