List app installs

curl --request GET \
  --url https://api.mobilerun.ai/devices/{deviceId}/apps/installs \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.mobilerun.ai/devices/{deviceId}/apps/installs', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.mobilerun.ai/devices/{deviceId}/apps/installs",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.mobilerun.ai/devices/{deviceId}/apps/installs"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.mobilerun.ai/devices/{deviceId}/apps/installs")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "installs": [
    {
      "appId": "<string>",
      "platform": "<string>",
      "startedAt": "2023-11-07T05:31:56Z",
      "status": "running",
      "updatedAt": "2023-11-07T05:31:56Z",
      "errorClass": "<string>"
    }
  ],
  "$schema": "https://example.com/schemas/ListAppInstallsOutputBody.json"
}

{
  "$schema": "https://example.com/schemas/ErrorModel.json",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example"
}

GET

devices

{deviceId}

apps

installs

List app installs

curl --request GET \
  --url https://api.mobilerun.ai/devices/{deviceId}/apps/installs \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.mobilerun.ai/devices/{deviceId}/apps/installs', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.mobilerun.ai/devices/{deviceId}/apps/installs",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.mobilerun.ai/devices/{deviceId}/apps/installs"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.mobilerun.ai/devices/{deviceId}/apps/installs")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "installs": [
    {
      "appId": "<string>",
      "platform": "<string>",
      "startedAt": "2023-11-07T05:31:56Z",
      "status": "running",
      "updatedAt": "2023-11-07T05:31:56Z",
      "errorClass": "<string>"
    }
  ],
  "$schema": "https://example.com/schemas/ListAppInstallsOutputBody.json"
}

{
  "$schema": "https://example.com/schemas/ErrorModel.json",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example"
}

Reports the backend’s view of background app-install attempts on this device — one entry per (platform, appId) pair that has an install-app attempt in progress or recently finished.

status reflects the install attempt, not device ground truth. It is running from the moment install-app returns 202, then flips to succeeded or failed once the background download + install finishes. list-apps remains authoritative for what is actually installed — a succeeded entry here is a strong signal, not a guarantee, and a device that goes offline mid-install can leave an entry running indefinitely until it is evicted. On iOS MDM devices specifically, succeeded only means the MDM InstallApplication command was accepted by the device’s MDM channel — the device may still be downloading or installing, or may yet fail on-device — so list-apps remains the authoritative check there too.

Unlike most Tools/Apps endpoints, this one is not gated on device readiness — it answers from an in-memory job table, not from the device, so it also works while the device is offline, crashed, or otherwise unreachable. That’s the situation this endpoint exists to surface: an install that fails because the device dropped mid-download has no other way to be observed by a caller. On failure, errorClass narrows down what went wrong from a small closed set:

download_failed — fetching the app asset failed
adb_install_failed — the download succeeded but adb install-multiple failed
timeout — the attempt exceeded its background time budget
panic — the install goroutine panicked
failed — anything else

Records are held in memory only and are lost on a service restart. Terminal (succeeded/failed) records are kept for roughly 15 minutes after their last update, then evicted; a running record is evicted after roughly 6 minutes without an update (longer than the install’s own background time budget, so this only ever drops genuine leaks, not slow-but-live installs).

Records are scoped to the tenant that owned the device when the install attempt started: after an ownership transfer (e.g. reassignment or a BYOD re-pair), the new owner cannot see the previous tenant’s install attempts, even while those records are still within their retention window above.

Authorizations

Authorization

string

header

required

Bearer token via Authorization header

Headers

X-Device-Display-ID

integer<int64>

default:0

Required range: x >= 0

Path Parameters

deviceId

string

required

Response

installs

object[] | null

required

Show child attributes

$schema

string<uri>

read-only

A URL to the JSON Schema for this object.

Example:

"https://example.com/schemas/ListAppInstallsOutputBody.json"

⌘I

Phones

Mobilerun Proxy

Mobilerun Numbers

Tasks

Workflows

Webhooks

List app installs

Authorizations

Headers

Path Parameters

Response