---
title: "Count who removing mailboxes reaches"
method: GET
path: "/mailboxes/removal-impact/"
tags: ["senders"]
---

# Count who removing mailboxes reaches

`GET /mailboxes/removal-impact/`

## Request

- Base URL: `https://api.getoneprofile.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.getoneprofile.ai/mailboxes/removal-impact/`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Before deleting mailboxes, taking them off their sender or moving them to another sender: how many live contacts it stops or leaves waiting, per sequence. A contact is only ever emailed from the mailbox that first emailed them, so a deleted mailbox stops them, an unassigned one makes them wait, and a move stops them in sequences the new sender is not on. Changes nothing.

## Query parameters

- `ids` string[], required: The mailboxes
- `action` 'delete' | 'unassign' | 'move', required: What is about to happen to a mailbox, for counting who it affects.
- `move_to_sender_profile_id` string, uuid, nullable: The sender a move puts them on

## Response `200`

Successful Response

- MailboxRemovalImpactReadSchema: Who deleting, unassigning or moving mailboxes reaches, counted before it happens.
  - `emailed_contacts` integer, required: Every contact these mailboxes have ever emailed; no other mailbox emails them.
  - `sequences` MailboxSequenceImpactSchema[], required
    - `sequence_id` string, uuid, required
    - `sequence_name` string, required
    - `stopped` integer, required: Live contacts in this sequence the change stops.
    - `waiting` integer, required: Live contacts in this sequence left waiting for the mailbox.
  - `stopped` integer, required: Live contacts the change stops. A contact is only ever emailed from the mailbox that first emailed them, so they are never moved to another one.
  - `waiting` integer, required: Live contacts left waiting until the mailbox is back on a sender.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found.
- `422`: Invalid request made to the API.
- `500`: Internal server error.
- `502`: Bad gateway error.
- `503`: Service unavailable.

---

[API](https://skmtc.dev/getoneprofile/apis/api-reference-oneprofile.md) · [All operations](https://skmtc.dev/getoneprofile/apis/api-reference-oneprofile/llms.txt) · [OpenAPI document](https://skmtc.dev/getoneprofile/apis/api-reference-oneprofile/revisions/4a6bd71e3f02?raw)