---
title: "List inbox placement tests"
method: GET
path: "/inbox-placement/tests"
tags: ["Inbox Placement"]
---

# List inbox placement tests

`GET /inbox-placement/tests`

## Request

- Base URL: `https://api.emailchaser.com/r`
- URL: `https://api.emailchaser.com/r/inbox-placement/tests`
- Auth: HTTP bearer

Lists every inbox placement test defined in the workspace, newest first. A test is the definition (content, which mailboxes to send from, and for a recurring test how often); each execution is a run, listed separately at /inbox-placement/runs.

## Response `200`

The workspace's tests

- ModelsInboxPlacementTestListResponse
  - `count` integer
  - `items` ModelsInboxPlacementTestResponse[]
    - `createdAt` string
    - `id` integer
    - `intervalHours` integer: IntervalHours is how often a recurring test repeats. Null for one-time.
    - `isPaused` boolean
    - `kind` string: Kind is one_time or recurring.
    - `lastRunAt` string
    - `name` string
    - `nextRunAt` string
    - `seedProviders` string[]: SeedProviders restricts the seed panel. Empty means every provider.
    - `senderEmailIds` integer[]: SenderEmailIDs are the mailboxes the test sends from.
    - `subject` string

## Other responses

- `401`: Unauthorized - invalid or missing API key
- `403`: The workspace does not hold the Inbox Placement add-on (code inbox_placement_required)
- `500`: Failed to load the tests

---

[API](https://skmtc.dev/emailchaser/apis/emailchaser-api.md) · [All operations](https://skmtc.dev/emailchaser/apis/emailchaser-api/llms.txt) · [OpenAPI document](https://skmtc.dev/emailchaser/apis/emailchaser-api/revisions/8b114990abb7?raw)