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

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

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

Retrieves a list of sessions for a <a>TestGridProject</a>.

## Query parameters

- `maxResult` string
- `nextToken` string

## Headers

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

## Request body

- ListTestGridSessionsRequest
  - `projectArn` string, required — ARN of a <a>TestGridProject</a>.
  - `status` 'ACTIVE' | 'CLOSED' | 'ERRORED' — Return only sessions in this state.
  - `creationTimeAfter` string, date-time — Return only sessions created after this time.
  - `creationTimeBefore` string, date-time — Return only sessions created before this time.
  - `endTimeAfter` string, date-time — Return only sessions that ended after this time.
  - `endTimeBefore` string, date-time — Return only sessions that ended before this time.
  - `maxResult` integer — Return only this many results at a time.
  - `nextToken` string — Pagination token.

## Response `200`

Success

- ListTestGridSessionsResult
  - `testGridSessions` TestGridSession[] — The sessions that match the criteria in a <a>ListTestGridSessionsRequest</a>.
    - `arn` string — The ARN of the session.
    - `status` 'ACTIVE' | 'CLOSED' | 'ERRORED' — The state of the session.
    - `created` string, date-time — The time that the session was started.
    - `ended` string, date-time — The time the session ended.
    - `billingMinutes` number, double — The number of billed minutes that were used for this session.
    - `seleniumProperties` string — A JSON object of options and parameters passed to the Selenium WebDriver.
  - `nextToken` string — Pagination token.

## Other responses

- `480` — NotFoundException
- `481` — ArgumentException
- `482` — InternalServiceException

---

[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/versions/a20834382f29/schema)