---
title: "Get email onboarding review status"
method: GET
path: "/v1/email/onboarding-review"
tags: ["Email"]
---

# Get email onboarding review status

`GET /v1/email/onboarding-review`

## Request

- Base URL: `https://api.samva.dev`
- URL: `https://api.samva.dev/v1/email/onboarding-review`
- Auth: API key in header `x-api-key`

Returns the customer-safe organization review decision, workflow stage, next action, and current sending-identity clearances. An organization that has not been reviewed yet is returned in the blocked initial state.

## Response `200`

OnboardingReviewStatus

- OnboardingReviewStatus
  - `decision` 'undecided' | 'approved' | 'rejected', required
  - `trustTier` 'screened' | 'probation' | 'established', required
  - `stage` 'collecting' | 'automated_review' | 'manual_review' | 'information_requested' | 'complete', required
  - `generation` integer, required
  - `canSend` boolean, required
  - `code` 'review_required' | 'review_in_progress' | 'information_required' | 'review_rejected' | 'identity_review_required' | 'identity_review_rejected' | 'identity_changed', nullable, required
  - `nextAction` 'wait_for_review' | 'provide_information' | 'verify_sending_identity' | 'reapply' | 'contact_support', nullable, required
  - `canReapply` boolean, required
  - `informationRequest` object, nullable, required
    - `id` string, required
    - `requestedFields` string[], required
    - `requestedAt` string, required
    - `canRespond` boolean, required
  - `identities` IdentityClearanceStatus[], required
    - `identityId` string, required
    - `decision` 'undecided' | 'approved' | 'rejected', required
    - `generation` integer, required
    - `canSend` boolean, required
    - `code` 'review_required' | 'review_in_progress' | 'information_required' | 'review_rejected' | 'identity_review_required' | 'identity_review_rejected' | 'identity_changed', nullable, required
    - `nextAction` 'wait_for_review' | 'provide_information' | 'verify_sending_identity' | 'reapply' | 'contact_support', nullable, required
    - `updatedAt` string, required
  - `updatedAt` string, nullable, required

## Other responses

- `401`: UnauthorizedError
- `403`: ForbiddenError
- `422`: ValidationError
- `500`: InternalError
- `504`: GatewayTimeoutError

---

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