App Store Connect icon

App Store Connect

Consume AppStore API

Actions73

Devices → List Devices

AI-generated

Summary

List devices from App Store Connect based on specified criteria.

Inputs

  • deviceId — Filter devices by their unique ID.
  • deviceName — Filter devices by their name.
  • platform — Specify the device platform (iOS, macOS, or Universal). Default is iOS.
  • status — Filter devices by their status (Enabled or Disabled). Default is Enabled.
  • udid — Filter devices by their UDID.
  • fieldsDevices — Specify the fields to return for each device (e.g., name, platform, udid, etc.).
  • sortBy — Determine the sort order of the returned devices (e.g., by ID or Name). Default is by name.
  • limit (required) — Set the maximum number of devices to return (between 1 and 200). Default is 1.

Output shape

a list of devices

Returned devices will include specified fields based on 'fieldsDevices' input. The response can be paginated based on the 'limit' parameter.

Examples

Example 1: List all enabled iOS devices, returning their names and UDIDs.

Set 'status' to 'Enabled', 'platform' to 'IOS', and 'fieldsDevices' to ['name', 'udid']. Limit the number to 10.

Discussion