Skip to main content
GET
/
builds
curl -X GET "https://nunu.ai/api/v1/builds?status=ready&platform=android&page=0&page_size=10" \
  -H "X-Api-Key: YOUR_API_TOKEN"

{
  "data": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "Production Build v1.2.3",
      "platform": "android",
      "status": "OK",
      "file_name": "app-release.apk",
      "file_size": 52428800,
      "pinned": true,
      "nunu_sdk": true,
      "tags": ["version:1.2.3", "env:production"],
      "created_at": "2026-03-03T15:50:19.544603+00:00",
      "last_used": "2026-03-10T10:30:00.000000+00:00",
      "description": "Release build for production"
    }
  ],
  "pagination": {
    "page": 0,
    "page_size": 10,
    "total_count": 25,
    "total_pages": 3
  }
}
Permission Required: project:manage-build-storage
Retrieve a paginated list of builds for your project.

​
Query Parameters

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

​
Response

​
data
Build[]
required
Array of build objects
​
pagination
object
required
Pagination information

​
Build Object

​
id
string
required
Unique identifier for the build (UUID)
​
name
string
required
Build name
​
platform
string
required
Target platform
​
status
string
required
Build status: uploading, ready, failed
​
file_name
string
required
Original file name
​
file_size
integer
required
File size in bytes
​
pinned
boolean
required
Whether the build is pinned (protected from auto-deletion)
​
nunu_sdk
boolean
required
Whether the build includes nunu SDK integration
​
tags
string[]
required
Tags associated with this build
​
created_at
string
required
ISO 8601 timestamp when the build was created
​
last_used
string
ISO 8601 timestamp when the build was last used in a run
​
description
string
Build description
curl -X GET "https://nunu.ai/api/v1/builds?status=ready&platform=android&page=0&page_size=10" \
  -H "X-Api-Key: YOUR_API_TOKEN"

{
  "data": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "Production Build v1.2.3",
      "platform": "android",
      "status": "OK",
      "file_name": "app-release.apk",
      "file_size": 52428800,
      "pinned": true,
      "nunu_sdk": true,
      "tags": ["version:1.2.3", "env:production"],
      "created_at": "2026-03-03T15:50:19.544603+00:00",
      "last_used": "2026-03-10T10:30:00.000000+00:00",
      "description": "Release build for production"
    }
  ],
  "pagination": {
    "page": 0,
    "page_size": 10,
    "total_count": 25,
    "total_pages": 3
  }
}

Authorizations

​
X-Api-Key
string
header
required

API key for authentication

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