---
title: "GET /tests"
method: GET
path: "/tests"
tags: ["Test"]
---

# GET /tests

`GET /tests`

## Request

- Base URL: `https://gtmetrix.com/api/2.0`
- URL: `https://gtmetrix.com/api/2.0/tests`
- Auth: HTTP basic

Retrieve the test list

## Query parameters

- `page[size]` integer: size of page for paginated results
- `page[number]` integer: page number of results
- `sort` string[]: Optional result list sort by test attribute. Supported test attributes: created, started, finished. Prepend the attribute with '-' for reverse sorting.
- `filter[:bool]` 'AND' | 'OR': boolean connector between each filter
- `filter[source]` string[]
- `filter[state]` string[]
- `filter[location]` string[]
- `filter[browser]` string[]
- `filter[created:eq]` integer[]
- `filter[created:gt]` integer[]
- `filter[created:gte]` integer[]
- `filter[created:lt]` integer[]
- `filter[created:lte]` integer[]
- `filter[started:eq]` integer[]
- `filter[started:gt]` integer[]
- `filter[started:gte]` integer[]
- `filter[started:lt]` integer[]
- `filter[started:lte]` integer[]
- `filter[finished:eq]` integer[]
- `filter[finished:gt]` integer[]
- `filter[finished:gte]` integer[]
- `filter[finished:lt]` integer[]
- `filter[finished:lte]` integer[]

## Response `200`

Successfully indexed test results

## Other responses

- `400`: E40000, E40005, E40006, E40007, E40008: Unknown request or Invalid query parameter
- `401`: E40100: Invalid API key
- `403`: E40300: E-mail address not validated
- `405`: E40500: HTTP method not allowed
- `429`: E42901: Rate limit exceeded
- `500`: E50000 Internal Server Error
- `502`: E50200 Application server temporarily unavailable
- `503`: E50300 Application server temporarily unavailable

---

[API](https://skmtc.dev/gtmetrix/apis/gtmetrix-openapi-specification.md) · [All operations](https://skmtc.dev/gtmetrix/apis/gtmetrix-openapi-specification/llms.txt) · [OpenAPI document](https://skmtc.dev/gtmetrix/apis/gtmetrix-openapi-specification/revisions/ef00e03bbfed?raw)