---
title: "Get guided first-email activation status"
method: GET
path: "/v1/activation"
tags: ["Onboarding"]
---

# Get guided first-email activation status

`GET /v1/activation`

## Request

- Base URL: `https://api.thrd.email`
- URL: `https://api.thrd.email/v1/activation`
- Auth: HTTP bearer

Returns first-class activation timestamps, the next deterministic integration action, and provider-agnostic deliverability diagnostics.

## Response `200`

Current activation state

- object
  - `status` 'awaiting_first_poll' | 'awaiting_first_inbound' | 'inbound_failed' | 'awaiting_first_ack' | 'awaiting_first_reply' | 'reply_failed' | 'active', required
  - `milestones` object, required
    - `api_key_last_used_at` string, date-time, nullable, required
    - `first_poll_at` string, date-time, nullable, required
    - `first_inbound_email_at` string, date-time, nullable, required
    - `first_ack_at` string, date-time, nullable, required
    - `first_successful_reply_at` string, date-time, nullable, required
  - `first_email_test` object, required
    - `inbox` object, required
      - `id` string, uuid, required
      - `address` string, email, required
    - `deliverability` object, required
      - `status` 'not_tested' | 'inbound_received' | 'reply_pending' | 'failed' | 'passed', required
      - `error` object, nullable, required
        - `code` 'provider_auth_failed' | 'sender_identity_unverified' | 'invalid_message_content' | 'provider_timeout' | 'provider_rate_limited' | 'recipient_rejected' | 'provider_unavailable' | 'inbound_payload_invalid' | 'inbound_storage_failed' | 'inbound_processing_failed', required
        - `message` string, required
        - `retryable` boolean, required
        - `observed_at` string, date-time, required
        - `request_id` string, uuid, required
    - `next_action` object, required: Discriminated by type; contains method/path/body or an external-email instruction.

## Other responses

- `401`: Missing or invalid API key
- `404`: Activation record or inbox not found

---

[API](https://skmtc.dev/thrd/apis/thrd-agent-email-api.md) · [All operations](https://skmtc.dev/thrd/apis/thrd-agent-email-api/llms.txt) · [OpenAPI document](https://skmtc.dev/thrd/apis/thrd-agent-email-api/revisions/d8a88129cd34?raw)