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

# POST /tests

`POST /tests`

## Request

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

Start a new test

## Response `202`

Test started successfully

## Other responses

- `400`: E40000, E40002, E40003, E40004 (Unknown request, Invalid parameter or body syntax errors)
- `401`: E40100: Invalid API key
- `402`: E40201: Insufficient API credits for this request
- `403`: E40300: E-mail address not validated. E40301: Your organization role does not permit this operation
- `405`: E40500: HTTP method not allowed
- `415`: E41500: Unsupported media type (Request must use Content-Type: application/vnd.api+json)
- `429`: E42900, E42901: Too many tests pending (Please wait for some to complete.)
- `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)