---
title: "Get inbound inbox readiness"
method: GET
path: "/inbox/status"
tags: ["Inbox"]
---

# Get inbound inbox readiness

`GET /inbox/status`

Returns one consolidated view of domain verification, webhook/function processing routes, deployed functions, and recent inbound mail. Agents should use this before guiding users through inbound email setup.

## Response `200`

Consolidated inbox readiness status

- object
  - `ready` boolean, required — True when an active inbound domain and at least one processing route are both ready.
  - `receiving_ready` boolean, required — True when at least one active verified or managed domain can receive mail.
  - `processing_ready` boolean, required — True when at least one receiving-ready domain has an enabled webhook or function route.
  - `summary` string, required
  - `next_actions` object[], required
    - `kind` 'add_domain' | 'verify_domain' | 'configure_processing' | 'send_test_email' | 'fix_failed_functions', required
    - `message` string, required — Human-readable next step.
    - `command` string — Suggested Primitive CLI command when there is an obvious next step.
  - `domains` object[], required
    - `id` string, required
    - `domain` string, required
    - `verified` boolean, required
    - `active` boolean, required
    - `managed` boolean, required
    - `receiving_ready` boolean, required
    - `processing_ready` boolean, required
    - `processing_route_count` integer, required
    - `endpoint_count` integer, required
    - `enabled_endpoint_count` integer, required
    - `function_endpoint_count` integer, required
    - `email_count` integer, required — Number of inbound emails received for this domain in the last 30 days.
    - `latest_email_received_at` string, date-time, nullable, required — Most recent inbound email received for this domain in the last 30 days.
    - `status` 'ready' | 'stored_only' | 'pending_dns' | 'inactive', required
  - `endpoints` object, required
    - `total` integer, required
    - `enabled` integer, required
    - `disabled` integer, required
    - `fallback_enabled` integer, required
    - `domain_scoped_enabled` integer, required
    - `http_enabled` integer, required
    - `function_enabled` integer, required
  - `functions` object, required
    - `total` integer, required
    - `deployed` integer, required
    - `pending` integer, required
    - `failed` integer, required
  - `recent_emails` object, required — Inbound email activity from the last 30 days.
    - `total` integer, required — Number of inbound emails received in the last 30 days.
    - `latest_received_at` string, date-time, nullable, required — Most recent inbound email received in the last 30 days.

## Other responses

- `401` — Invalid or missing API key
- `429` — Rate limit exceeded

---

[API](https://skmtc.dev/primitive/apis/primitive-api.md) · [All operations](https://skmtc.dev/primitive/apis/primitive-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/primitive/primitive-api/revisions/c2299d28022c/schema)