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

# List inbox placement runs

`GET /inbox-placement/runs`

## Request

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

Lists inbox placement runs newest first, optionally filtered to one test with ?testId=. Counters on a run are only final once its status is completed. Note that every rate is -1 when nothing has been scored yet, which means NOT MEASURED and must not be rendered as 0%.

## Query parameters

- `testId` integer
- `limit` integer

## Response `200`

The runs

- ModelsInboxPlacementListResponse
  - `count` integer
  - `items` ModelsInboxPlacementRunResponse[]
    - `completedAt` string
    - `createdAt` string
    - `error` string
    - `failed` integer
    - `id` integer
    - `inbox` integer
    - `inboxRate` integer: InboxRate is the whole-percentage share of SCORED probes that reached the primary inbox. -1 when nothing has been scored.
    - `messagesExpected` integer
    - `messagesSent` integer
    - `missing` integer: Missing counts probes never found in any folder, which usually means a silent block. Reported apart from spam because it is a worse problem with a different fix.
    - `promotions` integer: Promotions counts every Gmail category tab: promotions, social and updates. Delivered, but filtered away from the reader.
    - `seedsTargeted` integer
    - `sendersTargeted` integer
    - `spam` integer
    - `spamScore` integer: SpamScore is the content spam score in tenths of a point, so 47 is 4.7. -1 when not scored.
    - `startedAt` string
    - `status` string: Status is pending, sending, collecting, completed, failed or cancelled. Counters are only final once status is completed.
    - `testId` integer
    - `trigger` string: Trigger is manual or scheduled.

## 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 runs

---

[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)