Dead Accounts API
Review dead-account lifecycle findings for companies under your reseller account and take remediation actions.
| Method | Endpoint | Scope | Description |
|---|---|---|---|
| GET | /v1/reseller/dead-accounts | reports:read | List inactive or removal-blocked lifecycles by default. |
| GET | /v1/reseller/dead-accounts/{id} | reports:read | Get lifecycle detail, recent evidence, and available actions. |
| POST | /v1/reseller/dead-accounts/{id}/dismiss | users:write | Mark the lifecycle as a false positive. |
| POST | /v1/reseller/dead-accounts/{id}/reactivate | users:write | Reset the lifecycle to active. |
| DELETE | /v1/reseller/dead-accounts/{id}/remove-now | users:delete | Immediately remove the inactive user from the company when policy allows it. |
List Filters
| Parameter | Type | Description |
|---|---|---|
| company_id | integer | Restrict results to one company owned by the authenticated reseller. |
| status | string | One of active, suspected, inactive, removal_blocked, or removed. Defaults to inactive and removal_blocked. |
| string | Partial email search. | |
| per_page | integer | Items per page, capped at 100. |
Response Shape
{
"data": [
{
"id": 42,
"status": "inactive",
"company": {"id": 7, "name": "Acme Corporation"},
"user": {"id": 55, "name": "Jane Doe", "email": "jane{'@'}acme.test", "is_active": false},
"email": "jane{'@'}acme.test",
"evidence_counts": {"mail_hard_bounces": 3, "phishing_bounced_campaigns": 1},
"timestamps": {"inactive_at": "2026-05-19T10:00:00+00:00", "last_evidence_at": "2026-05-19T09:45:00+00:00"},
"status_reason": "Mail hard bounces: 3; phishing bounced campaigns: 1",
"removal_blocked_reason": null,
"policy": {"id": 1, "source_key": "global", "source_type": "global", "source_id": null},
"mailbox_billing_exclusion": {"excluded_from_billing": true, "reason": "System: dead account lifecycle inactive", "excluded_at": "2026-05-19T10:00:00+00:00"},
"recent_evidence": [],
"available_actions": {"dismiss": true, "reactivate": true, "remove_now": true}
}
],
"meta": {"current_page": 1, "last_page": 1, "per_page": 20, "total": 1}
}Action Errors
| Code | Status | Meaning |
|---|---|---|
| NOT_FOUND | 404 | The lifecycle does not exist or belongs to another reseller. |
| DEAD_ACCOUNT_ACTION_UNAVAILABLE | 422 | The lifecycle is not inactive/removal-blocked or has no actionable company user. |
| DEAD_ACCOUNT_REMOVAL_BLOCKED | 422 | The user cannot be automatically removed, usually because they are privileged or the last company admin. |
Ownership
Lifecycle IDs outside the authenticated reseller return 404 so integrations cannot enumerate other reseller data.