---
title: "POST /#X-Amz-Target=DeviceFarm_20150623.ListJobs"
method: POST
path: "/#X-Amz-Target=DeviceFarm_20150623.ListJobs"
---

# POST /#X-Amz-Target=DeviceFarm_20150623.ListJobs

`POST /#X-Amz-Target=DeviceFarm_20150623.ListJobs`

Gets information about jobs for a given test run.

## Query parameters

- `nextToken` string

## Headers

- `X-Amz-Target` 'DeviceFarm_20150623.ListJobs', required

## Request body

- ListJobsRequest — Represents a request to the list jobs operation.
  - `arn` string, required — The run's Amazon Resource Name (ARN).
  - `nextToken` string — An identifier that was returned from the previous call to this operation, which can be used to return the next set of items in the list.

## Response `200`

Success

- ListJobsResult — Represents the result of a list jobs request.
  - `jobs` Job[] — Information about the jobs.
    - `arn` string — The job's ARN.
    - `name` string — The job's name.
    - `type` 'BUILTIN_FUZZ' | 'BUILTIN_EXPLORER' | 'WEB_PERFORMANCE_PROFILE' | 'APPIUM_JAVA_JUNIT' | 'APPIUM_JAVA_TESTNG' | 'APPIUM_PYTHON' | 'APPIUM_NODE' | 'APPIUM_RUBY' | 'APPIUM_WEB_JAVA_JUNIT' | 'APPIUM_WEB_JAVA_TESTNG' | 'APPIUM_WEB_PYTHON' | 'APPIUM_WEB_NODE' | 'APPIUM_WEB_RUBY' | 'CALABASH' | 'INSTRUMENTATION' | 'UIAUTOMATION' | 'UIAUTOMATOR' | 'XCTEST' | 'XCTEST_UI' | 'REMOTE_ACCESS_RECORD' | 'REMOTE_ACCESS_REPLAY' — <p>The job's type.</p> <p>Allowed values include the following:</p> <ul> <li> <p>BUILTIN_FUZZ</p> </li> <li> <p>BUILTIN_EXPLORER. For Android, an app explorer that traverses an Android app, interacting with it and capturing screenshots at the same time.</p> </li> <li> <p>APPIUM_JAVA_JUNIT</p> </li> <li> <p>APPIUM_JAVA_TESTNG</p> </li> <li> <p>APPIUM_PYTHON</p> </li> <li> <p>APPIUM_NODE</p> </li> <li> <p>APPIUM_RUBY</p> </li> <li> <p>APPIUM_WEB_JAVA_JUNIT</p> </li> <li> <p>APPIUM_WEB_JAVA_TESTNG</p> </li> <li> <p>APPIUM_WEB_PYTHON</p> </li> <li> <p>APPIUM_WEB_NODE</p> </li> <li> <p>APPIUM_WEB_RUBY</p> </li> <li> <p>CALABASH</p> </li> <li> <p>INSTRUMENTATION</p> </li> <li> <p>UIAUTOMATION</p> </li> <li> <p>UIAUTOMATOR</p> </li> <li> <p>XCTEST</p> </li> <li> <p>XCTEST_UI</p> </li> </ul>
    - `created` string, date-time — When the job was created.
    - `status` 'PENDING' | 'PENDING_CONCURRENCY' | 'PENDING_DEVICE' | 'PROCESSING' | 'SCHEDULING' | 'PREPARING' | 'RUNNING' | 'COMPLETED' | 'STOPPING' — <p>The job's status.</p> <p>Allowed values include:</p> <ul> <li> <p>PENDING</p> </li> <li> <p>PENDING_CONCURRENCY</p> </li> <li> <p>PENDING_DEVICE</p> </li> <li> <p>PROCESSING</p> </li> <li> <p>SCHEDULING</p> </li> <li> <p>PREPARING</p> </li> <li> <p>RUNNING</p> </li> <li> <p>COMPLETED</p> </li> <li> <p>STOPPING</p> </li> </ul>
    - `result` 'PENDING' | 'PASSED' | 'WARNED' | 'FAILED' | 'SKIPPED' | 'ERRORED' | 'STOPPED' — <p>The job's result.</p> <p>Allowed values include:</p> <ul> <li> <p>PENDING</p> </li> <li> <p>PASSED</p> </li> <li> <p>WARNED</p> </li> <li> <p>FAILED</p> </li> <li> <p>SKIPPED</p> </li> <li> <p>ERRORED</p> </li> <li> <p>STOPPED</p> </li> </ul>
    - `started` string, date-time — The job's start time.
    - `stopped` string, date-time — The job's stop time.
    - `counters` object — The job's result counters.
      - `total` integer — The total number of entities.
      - `passed` integer — The number of passed entities.
      - `failed` integer — The number of failed entities.
      - `warned` integer — The number of warned entities.
      - `errored` integer — The number of errored entities.
      - `stopped` integer — The number of stopped entities.
      - `skipped` integer — The number of skipped entities.
    - `message` string — A message about the job's result.
    - `device` object — The device (phone or tablet).
      - `arn` string — The device's ARN.
      - `name` string — The device's display name.
      - `manufacturer` string — The device's manufacturer name.
      - `model` string — The device's model name.
      - `modelId` string — The device's model ID.
      - `formFactor` 'PHONE' | 'TABLET' — <p>The device's form factor.</p> <p>Allowed values include:</p> <ul> <li> <p>PHONE</p> </li> <li> <p>TABLET</p> </li> </ul>
      - `platform` 'ANDROID' | 'IOS' — <p>The device's platform.</p> <p>Allowed values include:</p> <ul> <li> <p>ANDROID</p> </li> <li> <p>IOS</p> </li> </ul>
      - `os` string — The device's operating system type.
      - `cpu` object — Information about the device's CPU.
        - `frequency` string — The CPU's frequency.
        - `architecture` string — The CPU's architecture (for example, x86 or ARM).
        - `clock` number, double — The clock speed of the device's CPU, expressed in hertz (Hz). For example, a 1.2 GHz CPU is expressed as 1200000000.
      - `resolution` object — The resolution of the device.
        - `width` integer — The screen resolution's width, expressed in pixels.
        - `height` integer — The screen resolution's height, expressed in pixels.
      - `heapSize` integer — The device's heap size, expressed in bytes.
      - `memory` integer — The device's total memory size, expressed in bytes.
      - `image` string — The device's image name.
      - `carrier` string — The device's carrier.
      - `radio` string — The device's radio.
      - `remoteAccessEnabled` boolean — Specifies whether remote access has been enabled for the specified device.
      - `remoteDebugEnabled` boolean — <p>This flag is set to <code>true</code> if remote debugging is enabled for the device.</p> <p>Remote debugging is <a href="https://docs.aws.amazon.com/devicefarm/latest/developerguide/history.html">no longer supported</a>.</p>
      - `fleetType` string — The type of fleet to which this device belongs. Possible values are PRIVATE and PUBLIC.
      - `fleetName` string — The name of the fleet to which this device belongs.
      - `instances` DeviceInstance[] — The instances that belong to this device.
        - `arn` string — The Amazon Resource Name (ARN) of the device instance.
        - `deviceArn` string — The ARN of the device.
        - `labels` String[] — An array of strings that describe the device instance.
        - `status` 'IN_USE' | 'PREPARING' | 'AVAILABLE' | 'NOT_AVAILABLE' — The status of the device instance. Valid values are listed here.
        - `udid` string — Unique device identifier for the device instance.
        - `instanceProfile` object — A object that contains information about the instance profile.
          - `arn` string — The Amazon Resource Name (ARN) of the instance profile.
          - `packageCleanup` boolean — When set to <code>true</code>, Device Farm removes app packages after a test run. The default value is <code>false</code> for private devices.
          - `excludeAppPackagesFromCleanup` String[] — <p>An array of strings containing the list of app packages that should not be cleaned up from the device after a test run completes.</p> <p>The list of packages is considered only if you set <code>packageCleanup</code> to <code>true</code>.</p>
          - `rebootAfterUse` boolean — When set to <code>true</code>, Device Farm reboots the instance after a test run. The default value is <code>true</code>.
          - `name` string — The name of the instance profile.
          - `description` string — The description of the instance profile.
      - `availability` 'TEMPORARY_NOT_AVAILABLE' | 'BUSY' | 'AVAILABLE' | 'HIGHLY_AVAILABLE' — Indicates how likely a device is available for a test run. Currently available in the <a>ListDevices</a> and GetDevice API methods.
    - `instanceArn` string — The ARN of the instance.
    - `deviceMinutes` object — Represents the total (metered or unmetered) minutes used by the job.
      - `total` number, double — When specified, represents the total minutes used by the resource to run tests.
      - `metered` number, double — When specified, represents only the sum of metered minutes used by the resource to run tests.
      - `unmetered` number, double — When specified, represents only the sum of unmetered minutes used by the resource to run tests.
    - `videoEndpoint` string — The endpoint for streaming device video.
    - `videoCapture` boolean — This value is set to true if video capture is enabled. Otherwise, it is set to false.
  - `nextToken` string — If the number of items that are returned is significantly large, this is an identifier that is also returned. It can be used in a subsequent call to this operation to return the next set of items in the list.

## Other responses

- `480` — ArgumentException
- `481` — NotFoundException
- `482` — LimitExceededException
- `483` — ServiceAccountException

---

[API](https://skmtc.net/aws/apis/devicefarm.md) · [All operations](https://skmtc.net/aws/apis/devicefarm/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/devicefarm/revisions/a20834382f29/schema)