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

# Get Email Logs

> Retrieve delivery logs for a specific email, showing its journey through the sending process.

### Headers

<ParamField header="Content-Type" type="string">
  `application/json`
</ParamField>

### Path Parameters

<ParamField path="email_id" type="string" required>
  The unique identifier of the email to retrieve logs for.
</ParamField>

### Response

<ResponseField name="status" type="number">
  HTTP status code. Returns `200` when logs are retrieved successfully.
</ResponseField>

<ResponseField name="message" type="string">
  A human-readable message describing the result of the operation.
</ResponseField>

<ResponseField name="data" type="array">
  Array of log entries in chronological order, tracking the email's delivery status.

  <Expandable title="properties">
    <ResponseField name="email_id" type="string">
      The email identifier this log entry belongs to.
    </ResponseField>

    <ResponseField name="team_id" type="string">
      The team ID that owns this email.
    </ResponseField>

    <ResponseField name="status" type="string">
      Status at this point in delivery. Possible values: `processing`, `queued`, `delivered`, `failed`, `bounced`, `complaint`.
    </ResponseField>

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

    <ResponseField name="to" type="string">
      Recipient email address for this log entry.
    </ResponseField>

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

    <ResponseField name="response" type="string">
      SMTP server response message. Contains detailed information from the receiving mail server.
    </ResponseField>

    <ResponseField name="code" type="string">
      SMTP response code (e.g., `250` for success, `550` for rejection).
    </ResponseField>

    <ResponseField name="mx_hostname" type="string">
      The MX hostname of the receiving mail server. Empty during initial processing stages.
    </ResponseField>

    <ResponseField name="time" type="number">
      Unix timestamp of when this log entry was created.
    </ResponseField>

    <ResponseField name="queued_at" type="string">
      ISO 8601 timestamp when the email was queued at this stage. May be empty for initial processing.
    </ResponseField>

    <ResponseField name="recipient" type="string">
      The recipient email address.
    </ResponseField>

    <ResponseField name="recipient_type" type="string">
      Type of recipient. Possible values: `to`, `cc`, `bcc`.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json Response theme={null}
  {
      "status": 200,
      "message": "email logs retrieved successfully.",
      "data": [
          {
              "email_id": "xxxxx",
              "team_id": "xxxxx",
              "status": "delivered",
              "from": "hello@yourdomain.com",
              "to": "user@example.com",
              "subject": "Test from http client",
              "response": "250 2.0.0 OK xxxxx 6a1803df08f44-882866ae38bsi47823636d6.1634 - gsmtp",
              "code": "250",
              "mx_hostname": "gmail-smtp-in.l.google.com",
              "time": 1763491342,
              "queued_at": "2025-11-18T18:42:23.494Z",
              "recipient": "user@example.com",
              "recipient_type": "to"
          },
          {
              "email_id": "xxxxx",
              "team_id": "xxxxx",
              "status": "queued",
              "from": "hello@yourdomain.com",
              "to": "user@example.com",
              "subject": "Test from http client",
              "response": "250 Message queued as xxxxx",
              "code": "250",
              "mx_hostname": "",
              "time": 1763491343,
              "queued_at": "2025-11-18T18:42:23Z",
              "recipient": "user@example.com",
              "recipient_type": "to"
          },
          {
              "email_id": "xxxxx",
              "team_id": "xxxxx",
              "status": "processing",
              "from": "hello@yourdomain.com",
              "to": "user@example.com",
              "subject": "Test from http client",
              "response": "250 2.0.0 Ok: queued as xxxxx",
              "code": "250",
              "mx_hostname": "",
              "time": 1763491341,
              "queued_at": "",
              "recipient": "user@example.com",
              "recipient_type": "to"
          }
      ]
  }
  ```
</ResponseExample>