Skip to main content
GET
/
v1
/
phones
/
{phone_id}
/
apps
Get Apps
curl --request GET \
  --url https://api.example.com/v1/phones/{phone_id}/apps

Documentation Index

Fetch the complete documentation index at: https://docs.tapkit.ai/llms.txt

Use this file to discover all available pages before exploring further.

Get the cached app list for a connected phone. If the app list is not cached, the Mac app refreshes it from the phone before returning the response. Use this as an inspection endpoint: it reads what the Mac app knows about the connected phone without launching or changing apps.

​
Request

curl https://api.tapkit.ai/v1/phones/{phone_id}/apps \
  -H "X-API-Key: joot_your_api_key"

​
Path Parameters

ParameterTypeDescription
phone_idstringThe phone identifier

​
Response

Returns JSON describing the apps available on the phone. The app list is intended for app discovery and for resolving app names before calling Open App. 
[
  {
    "name": "Settings",
    "bundle_id": "com.apple.Preferences"
  },
  {
    "name": "Safari",
    "bundle_id": "com.apple.mobilesafari"
  }
]

​
Example

import requests

response = requests.get(
    f"https://api.tapkit.ai/v1/phones/{phone_id}/apps",
    headers={"X-API-Key": "joot_..."}
)

apps = response.json()
for app in apps:
    print(app)