Apps

List apps

GET/api/v1/apps

Apps with at least one ready, unexpired file, newest first. Any role.

Query parameters

platformstring

Only files for this platform.

qstring

Case-insensitive substring of the name, filename or bundle id.

limitinteger

Page size, 1 to 100. Default 25.

cursorstring

`nextCursor` from the previous page. Opaque.

Header parameters

X-Organization-Idstring

Selects which of the caller's organizations the request acts on. When omitted, the caller's default organization is used.

Returns

objectstringrequired

dataarrayrequired

Show child attributes

idstring · uuidrequired

platformstringrequired

bundleIdstringrequired

namestringrequirednullable

Label of the latest file that had one.

iconUrlstringrequirednullable

Relative URL of the icon (getAppIcon); null when no icon could be extracted.

fileCountintegerrequired

Ready, unexpired files.

latestFileobjectrequirednullable

Newest ready file, whoever uploaded it and whatever its branch. Null only when every file has expired.

Show child attributes

idstring · uuidrequired

namestringrequired

versionstringrequirednullable

buildNumberstringrequirednullable

createdAtstring · date-timerequired

expiresAtstring · date-timerequired

createdAtstring · date-timerequired

updatedAtstring · date-timerequired

nextCursorstring

Pass as `cursor` for the next page. Absent on the last page.

Request

curl https://app.mobilenext.ai/api/v1/apps \
  -X GET \
  -H 'Authorization: Bearer mob_...'

Response

A page of apps

{
  "object": "list",
  "data": [
    {
      "id": "string",
      "platform": "android",
      "bundleId": "com.acme.shop",
      "name": "Acme Shop",
      "iconUrl": "/api/v1/apps/7d2a90c1-5b0e-4f7a-8c11-2e9f0a4b6d33/icon",
      "fileCount": 0,
      "latestFile": {
        "id": "string",
        "name": "string",
        "version": "4.2.0",
        "buildNumber": "4201",
        "createdAt": "2026-01-01T00:00:00Z",
        "expiresAt": "2026-01-01T00:00:00Z"
      },
      "createdAt": "2026-01-01T00:00:00Z",
      "updatedAt": "2026-01-01T00:00:00Z"
    }
  ],
  "nextCursor": "string"
}

Get an app

GET/api/v1/apps/{appId}

Any role. An app whose files have all expired is still returned, with fileCount: 0 and latestFile: null.

Path parameters

appIdstring · uuidrequired

App UUID

Header parameters

X-Organization-Idstring

Selects which of the caller's organizations the request acts on. When omitted, the caller's default organization is used.

Returns

idstring · uuidrequired

platformstringrequired

bundleIdstringrequired

namestringrequirednullable

Label of the latest file that had one.

iconUrlstringrequirednullable

Relative URL of the icon (getAppIcon); null when no icon could be extracted.

fileCountintegerrequired

Ready, unexpired files.

latestFileobjectrequirednullable

Newest ready file, whoever uploaded it and whatever its branch. Null only when every file has expired.

Show child attributes

idstring · uuidrequired

namestringrequired

versionstringrequirednullable

buildNumberstringrequirednullable

createdAtstring · date-timerequired

expiresAtstring · date-timerequired

createdAtstring · date-timerequired

updatedAtstring · date-timerequired

Request

curl https://app.mobilenext.ai/api/v1/apps/{appId} \
  -X GET \
  -H 'Authorization: Bearer mob_...'

Response

The app

{
  "id": "string",
  "platform": "android",
  "bundleId": "com.acme.shop",
  "name": "Acme Shop",
  "iconUrl": "/api/v1/apps/7d2a90c1-5b0e-4f7a-8c11-2e9f0a4b6d33/icon",
  "fileCount": 0,
  "latestFile": {
    "id": "string",
    "name": "string",
    "version": "4.2.0",
    "buildNumber": "4201",
    "createdAt": "2026-01-01T00:00:00Z",
    "expiresAt": "2026-01-01T00:00:00Z"
  },
  "createdAt": "2026-01-01T00:00:00Z",
  "updatedAt": "2026-01-01T00:00:00Z"
}

List an app's files

GET/api/v1/apps/{appId}/files

Same as listFiles, restricted to this app. For a branch's newest build: ?branch=main&limit=1.

Path parameters

appIdstring · uuidrequired

App UUID

Query parameters

sha256string

Only the file with this lowercase hex SHA-256.

platformstring

Only files for this platform.

bundleIdstring

Only files with this bundle id.

branchstring

Only files whose build.branch equals this.

commitstring

Only files whose build.commit equals this.

statusstring

Only files in this status. Without it, ready and processing files are listed; pendingUpload and failed are for debugging.

qstring

Case-insensitive substring of the name, filename or bundle id.

limitinteger

Page size, 1 to 100. Default 25.

cursorstring

`nextCursor` from the previous page. Opaque.

Header parameters

X-Organization-Idstring

Selects which of the caller's organizations the request acts on. When omitted, the caller's default organization is used.

Returns

objectstringrequired

dataarrayrequired

Show child attributes

idstring · uuidrequired

statusstringrequired

pendingUpload: bytes not verified yet. processing: verification running (seen only by a concurrent caller). ready: installable. failed: see failureReason; creating the same sha256 again resets it.

appstring · uuidrequirednullable

The app this file belongs to, once metadata is extracted.

platformstringrequirednullable

Known once metadata is extracted.

filenamestringrequired

filesizeinteger · int64required

sha256stringrequired

namestringrequired

Display name. Defaults to the filename until metadata is extracted.

bundleIdstringrequirednullable

Android package name or iOS bundle identifier.

versionstringrequirednullable

Version name (Android) or CFBundleShortVersionString (iOS).

buildNumberstringrequirednullable

Version code (Android) or CFBundleVersion (iOS).

minOsVersionstringrequirednullable

Minimum OS version the build supports.

isSimulatorbooleanrequired

True for an iOS simulator build.

buildobjectrequirednullable

Show child attributes

branchstring

commitstring

ciRunUrlstring · uri

https only. Stored and displayed, never fetched.

sourcestringrequired

How the file was created, derived from the credential.

organizationstringrequired

Organization that owns the file.

userstringrequirednullable

Uploader; null if the user was deleted.

failureReasonstringrequirednullable

Why the file failed; null otherwise.

createdAtstring · date-timerequired

lastUsedAtstring · date-timerequirednullable

Last dedup hit or install.

expiresAtstring · date-timerequired

The file and its bytes are deleted after this.

nextCursorstring

Pass as `cursor` for the next page. Absent on the last page.

Request

curl https://app.mobilenext.ai/api/v1/apps/{appId}/files \
  -X GET \
  -H 'Authorization: Bearer mob_...'

Response

A page of the app's files

{
  "object": "list",
  "data": [
    {
      "id": "string",
      "status": "pendingUpload",
      "app": "string",
      "platform": "android",
      "filename": "app-release.apk",
      "filesize": 48211033,
      "sha256": "string",
      "name": "Checkout fix",
      "bundleId": "com.acme.shop",
      "version": "4.2.0",
      "buildNumber": "4201",
      "minOsVersion": "8.0",
      "isSimulator": false,
      "build": {
        "branch": "fix/checkout",
        "commit": "3dbd301",
        "ciRunUrl": "https://github.com/acme/shop/actions/runs/991"
      },
      "source": "api",
      "organization": "string",
      "user": "string",
      "failureReason": "checksum_mismatch",
      "createdAt": "2026-01-01T00:00:00Z",
      "lastUsedAt": "2026-01-01T00:00:00Z",
      "expiresAt": "2026-01-01T00:00:00Z"
    }
  ],
  "nextCursor": "string"
}

Get an app's icon

GET/api/v1/apps/{appId}/icon

The icon as PNG (at most 512×512). Supports If-None-Match with the returned ETag. Any role.

Path parameters

appIdstring · uuidrequired

App UUID

Header parameters

If-None-Matchstring

X-Organization-Idstring

Selects which of the caller's organizations the request acts on. When omitted, the caller's default organization is used.

Was this page helpful?

List apps​

Get an app​

List an app's files​

Get an app's icon​

List apps

Get an app

List an app's files

Get an app's icon