Skip to main content
GET
Permission Required: project:manage-build-storage
Retrieve a paginated list of builds for your project.

Query Parameters

string
Filter by build status (e.g., OK, UNHEALTHY)
boolean
Filter by pinned status: true for pinned builds only, false for non-pinned only
boolean
Filter by nunu SDK integration: true for SDK builds only, false for non-SDK only
string
Filter by platform: windows, android, ios-native
string
Filter by tags (comma-separated). All specified tags must match. Example: tags=release,candidate
integer
default:"0"
Page number (0-indexed)
integer
default:"20"
Results per page (1-100)

Response

Build[]
required
Array of build objects
object
required
Pagination information

Build Object

string
required
Unique identifier for the build (UUID)
string
required
Build name
string
required
Target platform
string
required
Build status: uploading, ready, failed
string
required
Original file name
integer
required
File size in bytes
boolean
required
Whether the build is pinned (protected from auto-deletion)
boolean
required
Whether the build includes nunu SDK integration
string[]
required
Tags associated with this build
string
required
ISO 8601 timestamp when the build was created
string
ISO 8601 timestamp when the build was last used in a run
string
Build description

Authorizations

X-Api-Key
string
header
required

API key for authentication

Path Parameters

projectId
string
required

The project ID. You can copy it from the project settings page or the project URL in the dashboard.

Query Parameters

status
string

Filter by build status (e.g., OK, UNHEALTHY)

pinned
boolean

Filter by pinned status

nunu_sdk
boolean

Filter by nunu SDK integration

platform
enum<string>

Filter by platform

Available options:
windows,
macos,
linux,
android,
ios-native,
ios-simulator,
xbox,
playstation
tags
string

Filter by tags (comma-separated). All specified tags must match.

page
integer
default:0

Page number (0-indexed)

page_size
integer
default:20

Results per page (1-100)

Required range: 1 <= x <= 100

Response

Successful response

data
object[]
pagination
object