---
title: "Get truthful activation state and recommended next actions"
method: GET
path: "/api/me/activation"
tags: ["Account"]
---

# Get truthful activation state and recommended next actions

`GET /api/me/activation`

## Request

- Base URL: `https://domani.run`
- URL: `https://domani.run/api/me/activation`
- Auth: HTTP bearer

Returns server-derived product milestones and capability-aware next actions. Token creation, token use, page views, and client checklist state are deliberately excluded.

## Response `200`

Activation projection

- ActivationProjection: Versioned, server-derived evidence of meaningful product activation. Authentication and token reads do not count as activation.
  - `version` 2, required
  - `account_created_at` string, date-time, required
  - `entry` object, required
    - `brand` string, required
    - `surface` string, required
    - `intent` string, required
  - `milestones` object, required
    - `mailbox_created_at` string, date-time, nullable, required
    - `first_message_sent_at` string, date-time, nullable, required
    - `first_message_received_at` string, date-time, nullable, required
    - `custom_domain_activated_at` string, date-time, nullable, required
    - `programmatic_action_completed_at` string, date-time, nullable, required
    - `first_webhook_delivery_succeeded_at` string, date-time, nullable, required: First successful mailbox webhook delivery, whether test or live inbound
  - `status` 'first_run' | 'setup_active' | 'mail_active' | 'mail_loop_complete' | 'domain_active' | 'programmatic_active' | 'multi_surface_active', required
  - `recommended_actions` object[], required
    - `id` string, required
    - `label` string, required
    - `priority` integer, required
    - `surfaces` string[], required
    - `href` string
    - `operation` string, required
  - `available_paths` string[], required
  - `dismissed_version` integer, required
  - `pending_claim` object, nullable, required
    - `slug` string, required

## Other responses

- `401`: Missing or invalid API key
- `429`: Rate limit exceeded - wait and retry

---

[API](https://skmtc.dev/domani/apis/domani-run-api.md) · [All operations](https://skmtc.dev/domani/apis/domani-run-api/llms.txt) · [OpenAPI document](https://skmtc.dev/domani/apis/domani-run-api/revisions/7679f8159533?raw)