{
  "message": {
    "id": "rcv_01JZX8K3M9Q4P7VN2YB6RTDC0E",
    "agent_id": "agt_01JZX8K3M9Q4P7VN2YB6RTDC0E",
    "thread_id": "thrd_01JZX8K3M9Q4P7VN2YB6RTDC0E",
    "from": {
      "address": "jordan@example.com",
      "name": "<name>"
    },
    "envelope_from": "<envelope_from>",
    "to": "jordan@example.com",
    "subject": "<subject>",
    "is_thread_reply": false,
    "in_reply_to_message_id": "msg_01JZX8K3M9Q4P7VN2YB6RTDC0E",
    "thread_root_message_id": "msg_01JZX8K3M9Q4P7VN2YB6RTDC0E",
    "body_text": "<body_text>",
    "body_html": "<body_html>",
    "body_text_excerpt": "<body_text_excerpt>",
    "extracted_text": "<extracted_text>",
    "extracted_html": "<extracted_html>",
    "codes": [{ "value": null }],
    "links": [{ "url": null, "kind": null }],
    "spf_pass": false,
    "dkim_pass": false,
    "dkim": "pass",
    "dkim_domain": "<dkim_domain>",
    "dmarc": "pass",
    "auth_failed": false,
    "has_attachment": false,
    "attachments": [
      {
        "id": null,
        "filename": null,
        "content_type": null,
        "size": null,
        "content_id": null,
        "inline": null
      }
    ],
    "attachments_omitted": [
      {
        "filename": null,
        "content_type": null,
        "size": null,
        "reason": null
      }
    ],
    "attachments_omitted_count": 0,
    "raw_omitted": "too_large",
    "over_limit": "quota_exceeded",
    "parse_status": "parsed",
    "injection_score": 0,
    "quarantined": false,
    "received_at": "2026-10-04T12:00:00.000Z",
    "raw_url": "<raw_url>",
    "created_at": "2026-10-04T12:00:00.000Z"
  },
  "timed_out": false
}

200  The matching message, or none in time.
400  Invalid request — malformed JSON or a field failed
     validation. Also feature_not_enabled when this
     server has a feature switched off (custom domains
     before they are available).
401  Missing or invalid API key.
403  The API key lacks the required scope
     (insufficient_scope), or the token belongs to an
     app connected by sign-in and this operation is
     closed to connected apps
     (connected_app_not_allowed).
409  Conflict — duplicate resource, an in-progress
     idempotent request, a draft or scheduled message
     that started sending while it was being changed, or
     a thread deleted for good while one of its messages
     is being sent (duplicate_resource); or an agent
     name more than one agent has (agent_name_conflict:
     use the agent's id); or a status change on an
     archived agent, since archiving cannot be undone
     (agent_archived).
429  Rate or quota limit exceeded. The body's resets_at
     and retry_after_seconds say when the request can
     succeed. A Retry-After header is sent only when
     that is 60 seconds or less; a longer wait (an
     hourly, daily or monthly cap) sends none, so retry
     at resets_at or raise the limit instead of
     sleeping.
500  Internal server error.