App Builds

List All Builds for a given App

get

List all builds for a given app, with associated metadata. The default paging limit is 100 items per page.

Authorizations

jwtapiToken

Path parameters

platformstringRequired

The platform of the app. Either ios or android

Example: ios

appIdstringRequired

The unique identifier for the app. On Android this is the package name, on iOS this is the bundle identifier.

Example: com.sample.appId

Query parameters

versionNamestringOptional

The version name to filter by, example "1.0.0".

Example: 1.0.0

buildNumberstringOptional

The build number to filter by, example "1". This is the versionCode on Android and CFBundleVersion on iOS.

Example: 1

tagsstringOptional

The tags to filter by, example "tag1,tag2".

Example: tag1,tag2

latestbooleanOptional

Only return the latest version if more than one version matches the filter.

Example: true

pagenumberOptional

The index of the desired page

Example: 1

limitnumberOptional

The number of items to return per page

Example: 10

Responses

200

OK

application/json

totalinteger · int32OptionalExample: 25

nextPagenumber · int32 · nullableOptionalExample: 2

400

Bad Request

application/json

401

Unauthorized

application/json

404

Not Found

application/json

get/v2/apps/{platform}/{appId}/builds

HTTPcURLJavaScriptPython

GET /v2/apps/{platform}/{appId}/builds HTTP/1.1
Host: api.appetize.io
Accept: */*

{
  "total": 25,
  "nextPage": 2,
  "builds": [
    {
      "id": "b_eeWohT2piec0",
      "appId": "com.sample.appId",
      "platform": "ios",
      "name": "My App",
      "iconUrl": "https://appetize.io/images/icon.png",
      "versionName": "1.0.0",
      "buildNumber": "1",
      "tags": [
        "tag1",
        "tag2"
      ],
      "note": "This is a note",
      "created": "2020-01-01T00:00:00.000Z",
      "createdBy": "[e-mail]",
      "updated": "2020-01-01T00:00:00.000Z",
      "updatedBy": "[e-mail]",
      "lastPlayed": "2020-01-01T00:00:00.000Z",
      "metadata": {
        "android": {
          "packageName": "com.sample.appId",
          "name": "My App",
          "versionName": "1.0.0",
          "versionCode": 22,
          "minSDKVersion": 23,
          "targetSDKVersion": 33,
          "architectures": [
            "arm64"
          ],
          "permissions": [
            "android.permission.INTERNET"
          ],
          "localizations": [
            "en",
            "de",
            "it"
          ]
        }
      }
    }
  ]
}