Skip to main content

View Thread

GET/api/v1/mail/threads/{thread_id}

Overview​

Retrieve all messages in a conversation thread, ordered chronologically. Thread IDs are computed from RFC 2822 References and In-Reply-To headers.

Path Parameters​

thread_idstringrequired

Thread ID (typically the Message-ID of the first email in the chain)

Request​

curl "https://spideriq.ai/api/v1/mail/threads/%3Cabc123%40mail.zoho.com%3E" \
  -H "Authorization: Bearer <client_id>:<api_key>:<api_secret>"

Response​

{
  "success": true,
  "thread_id": "<abc123@mail.zoho.com>",
  "message_count": 3,
  "messages": [
    {
      "id": 1230,
      "direction": "outbound",
      "from_address": "alice@company.com",
      "to_addresses": ["bob@prospect.com"],
      "subject": "Quick question about your services",
      "body_text": "Hi Bob, I noticed your company...",
      "date": "2026-02-01T14:00:00"
    },
    {
      "id": 1234,
      "direction": "inbound",
      "from_address": "bob@prospect.com",
      "to_addresses": ["alice@company.com"],
      "subject": "Re: Quick question about your services",
      "body_text": "Thanks for reaching out!...",
      "date": "2026-02-02T10:15:00"
    }
  ]
}