List builds
List all non-pending builds for an application with filtering and sorting. Requires builds:read scope.
/applications/{application_id}/buildsAuthorization
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"
- "size_total_bytes"
- "built_at"
- "created_at"
Sort direction.
"asc"Value in
- "asc"
- "desc"
Items per page (default varies by endpoint; max 100).
1 <= value <= 10015Filter by platform slugs. Accepts a single slug or comma-separated list (e.g. ios, android,ios). Returns 422 if any slug is invalid. See Platforms for valid platform slugs.
Filter by stream ID or name. Accepts a single value or comma-separated list. Returns 422 if any identifier is invalid for this application.
Filter by label ID or name. Accepts a single value or comma-separated list. Returns 422 if any identifier is invalid for this application.
Filter by custom target ID or name. Accepts a single value or comma-separated list. Scoped to targets available to this application (workspace-level and application-level). If the workspace plan does not include custom target access, this filter is ignored and a note is included in the response message. Returns 422 if any identifier is invalid.
Response Body
application/json
application/json
application/json
application/json
curl -X GET -G "https://example.comapplications/aBc1234/builds" \ --data-urlencode "platforms=android,ios" \ --data-urlencode "streams=production,staging" \ --data-urlencode "labels=rc,hotfix" \ --data-urlencode "custom_targets=Samsung Galaxy Store,Amazon Appstore" \ -H "Authorization: Bearer YOUR_API_KEY"{ "message": "Builds retrieved successfully.", "data": [ { "id": "xYz9876", "build_structure": "file", "version": "1.0.1", "version_short": "1.0.1", "version_semantic_major": 1, "version_semantic_minor": 0, "version_semantic_patch": 1, "version_semantic_extra": null, "version_semantic_meta": null, "build_number": "398", "platform": { "identifier": "windows", "name": "Windows", "short_name": "Windows", "upload_instruction": "Upload a .exe, .msi, or .zip installer." }, "stream": { "id": "stR4567", "name": "nightlies", "description": "Nightly development builds", "retention_days": 30, "created_at": "2025-06-10T09:15:00.000000Z", "updated_at": "2025-06-15T14:30:00.000000Z" }, "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" } ], "architectures": [ { "identifier": "x64", "name": "x64", "description": "64-bit x86 (AMD64 / Intel 64)" }, { "identifier": "arm64v8", "name": "ARM64v8", "description": "ARMv8-A 64-bit" } ], "notes": "Example build notes here.", "size_total_bytes": 52428800, "size_total_string": "50.00 MB", "metadata_total_bytes": 4096, "build_source": "ghactions", "ci_pipeline": { "ci_pipeline_name": "Nightly Build", "ci_pipeline_url": "https://github.com/buildstash/example/actions/workflows/nightly.yml", "ci_run_id": "12345678901", "ci_run_url": "https://github.com/buildstash/example/actions/runs/12345678901", "ci_build_duration": "00:05:00" }, "scm": { "scm_host_type": "git", "scm_host": "github", "scm_repo_name": "buildstash/example", "scm_repo_url": "https://github.com/buildstash/example", "scm_branch": "main", "scm_commit_sha": "1a2b3c4d5e6f7g8h9i0j1k2l3m4n5o6", "scm_commit_sha_short": "1a2b3c4", "scm_commit_url": "https://github.com/buildstash/example/commit/1a2b3c4d5e6f7g8h9i0j1k2l3m4n5o6" }, "pending": false, "modal_url": "https://acme.buildstash.com/applications/aBc1234/builds/xYz9876", "download_url": "https://acme.buildstash.com/builds/xYz9876/download", "built_at": "2025-06-15T14:30:00.000000Z", "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": "The platform identifier android2 is invalid."}