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