---
title: "GET /api/v0/tests"
method: GET
path: "/api/v0/tests"
tags: ["TestLocally"]
---

# GET /api/v0/tests

`GET /api/v0/tests`

Lists recent tests matching criteria

## Query parameters

- `start` string
- `end` string
- `owners[]` string[]
- `locations[]` string[]
- `target` string
- `scheduled` string
- `browser` string
- `viewport` string
- `page` integer
- `limit` integer

## Response `200`

List of tests matching criteria

- TestOutput[]
  - `id` string
  - `created` integer — unix timestamp
  - `servers` string
  - `locations` LocationOutput[]
    - `server` string
    - `title` string
    - `city` string
    - `country` string
    - `latitude` number, float
    - `longitude` number, float
  - `target` string
  - `browser` 'chromium' | 'chrome' | 'firefox' | 'msedge' | 'webkit'
  - `viewport` ViewportOutput
    - `requested` 'desktop' | 'tablet' | 'phone'
    - `size` string
  - `bucketId` string
  - `headers` object
  - `screenshots` ScreenshotOutput[]
    - `id` string
    - `server` string
    - `state` 'launching' | 'locating' | 'navigating' | 'scrolling' | 'lazy' | 'taking' | 'taken' | 'crunching' | 'uploading' | 'done' | 'error' — Any states except for done and error indicate a test in progress
    - `thumbnail` string — Thumbnail URL
    - `fullpage` string — Fullpage screenshot URL
    - `video` string — URL to the video recording of the test
    - `taken` integer, nullable — unix timestamp
    - `error` 'browser' | 'browser-navigation' | 'browser-timeout' | 'browser-launch' | 'screenshot' | 'safety-check' | 'crunch' | 'upload' | 'invalid-viewport' — reason for the error
    - `errorDetails` string — details about the error condition
    - `locale` string
    - `position` PositionOutput
      - `latitude` number, float
      - `longitude` number, float
    - `targetIp` string, nullable
  - `ip` string
  - `ownerId` string
  - `teamId` string
  - `ownerEmail` string
  - `skipCompression` boolean
  - `scheduleId` string
  - `clicks` string[]

## Other responses

- `400` — Invalid search criteria

---

[API](https://skmtc.dev/testlocal/apis/testlocally.md) · [All operations](https://skmtc.dev/testlocal/apis/testlocally/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/testlocal/testlocally/revisions/f6ef68f805e6/schema)