Dead Accounts API

Review dead-account lifecycle findings for companies under your reseller account and take remediation actions.

MethodEndpointScopeDescription
GET/v1/reseller/dead-accountsreports:readList inactive or removal-blocked lifecycles by default.
GET/v1/reseller/dead-accounts/{id}reports:readGet lifecycle detail, recent evidence, and available actions.
POST/v1/reseller/dead-accounts/{id}/dismissusers:writeMark the lifecycle as a false positive.
POST/v1/reseller/dead-accounts/{id}/reactivateusers:writeReset the lifecycle to active.
DELETE/v1/reseller/dead-accounts/{id}/remove-nowusers:deleteImmediately remove the inactive user from the company when policy allows it.

List Filters

ParameterTypeDescription
company_idintegerRestrict results to one company owned by the authenticated reseller.
statusstringOne of active, suspected, inactive, removal_blocked, or removed. Defaults to inactive and removal_blocked.
emailstringPartial email search.
per_pageintegerItems 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

CodeStatusMeaning
NOT_FOUND404The lifecycle does not exist or belongs to another reseller.
DEAD_ACCOUNT_ACTION_UNAVAILABLE422The lifecycle is not inactive/removal-blocked or has no actionable company user.
DEAD_ACCOUNT_REMOVAL_BLOCKED422The 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.