> ## Documentation Index
> Fetch the complete documentation index at: https://docs.notvis.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Email

> Retrieve the status and details of an email message.

## Request Headers

<ParamField header="Authorization" type="string" required>
  Bearer token. Format: `Bearer nc_live_your_api_key`
</ParamField>

## Path Parameters

<ParamField path="message_id" type="string" required>
  The unique message ID returned when the email was sent.
</ParamField>

## Response

<ResponseField name="message_id" type="string">
  Unique message identifier.
</ResponseField>

<ResponseField name="account_id" type="string">
  Your account ID.
</ResponseField>

<ResponseField name="from" type="object">
  Sender email address and name.
</ResponseField>

<ResponseField name="to" type="array">
  List of To recipients.
</ResponseField>

<ResponseField name="cc" type="array">
  List of CC recipients.
</ResponseField>

<ResponseField name="bcc" type="array">
  List of BCC recipients.
</ResponseField>

<ResponseField name="subject" type="string">
  Email subject line.
</ResponseField>

<ResponseField name="tags" type="string[]">
  Tags attached to this email.
</ResponseField>

<ResponseField name="metadata" type="object">
  Custom metadata attached to this email.
</ResponseField>

<ResponseField name="status" type="string">
  Current status. One of: `queued`, `scheduled`, `sending`, `sent`, `delivered`, `bounced`, `failed`.
</ResponseField>

<ResponseField name="created_at" type="string">
  ISO 8601 timestamp of when the email was created.
</ResponseField>

<Note>
  Email data is available for 7 days after creation. The response does not include `body_html` or `body_text` for security — only metadata and status.
</Note>

<RequestExample>
  ```bash cURL theme={null}
  curl https://api.notvis.com/v1/emails/messages/550e8400-e29b-41d4-a716-446655440000 \
    -H "Authorization: Bearer nc_live_your_api_key"
  ```

  ```javascript Node.js theme={null}
  const response = await fetch(
    'https://api.notvis.com/v1/emails/messages/550e8400-e29b-41d4-a716-446655440000',
    { headers: { 'Authorization': 'Bearer nc_live_your_api_key' } }
  );
  const email = await response.json();
  console.log(email.status);
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      'https://api.notvis.com/v1/emails/messages/550e8400-e29b-41d4-a716-446655440000',
      headers={'Authorization': 'Bearer nc_live_your_api_key'},
  )
  print(response.json()['status'])
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "message_id": "550e8400-e29b-41d4-a716-446655440000",
    "account_id": "acc_123",
    "from": { "email": "hello@yourdomain.com", "name": "Your App" },
    "to": [{ "email": "user@example.com", "name": "John Doe" }],
    "subject": "Welcome to Our App",
    "tags": ["welcome", "onboarding"],
    "metadata": { "user_id": "usr_123" },
    "status": "delivered",
    "created_at": "2026-07-12T10:00:00Z"
  }
  ```

  ```json 404 Not Found theme={null}
  {
    "code": 404,
    "message": "message not found"
  }
  ```
</ResponseExample>