Get a conversation with all messages

Sent emails and inbound messages merged chronologically.

curl -X GET "https://api.supasend.io/v1/inbox/threads/507f1f77bcf86cd799439011" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY"

import requests
import json

url = "https://api.supasend.io/v1/inbox/threads/507f1f77bcf86cd799439011"
headers = {
  "Content-Type": "application/json",
  "X-API-Key": "YOUR_API_KEY"
}

response = requests.get(url, headers=headers)
print(response.json())

const response = await fetch("https://api.supasend.io/v1/inbox/threads/507f1f77bcf86cd799439011", {
  method: "GET",
  headers: {
  "Content-Type": "application/json",
  "X-API-Key": "YOUR_API_KEY"
}
});

const data = await response.json();
console.log(data);

package main

import (
    "fmt"
    "net/http"
)

func main() {

    req, err := http.NewRequest("GET", "https://api.supasend.io/v1/inbox/threads/507f1f77bcf86cd799439011", nil)
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/json")
    req.Header.Set("X-API-Key", "YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    fmt.Println("Response Status:", resp.Status)
}

require 'net/http'
require 'json'

uri = URI('https://api.supasend.io/v1/inbox/threads/507f1f77bcf86cd799439011')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Get.new(uri)
request['Content-Type'] = 'application/json'
request['X-API-Key'] = 'YOUR_API_KEY'

response = http.request(request)
puts response.body

{
  "thread": {
    "id": "example_string",
    "mailbox_id": "example_string",
    "root_message_id": "example_string",
    "subject": "example_string",
    "participants": [
      "example_string"
    ],
    "email_job_id": "user@example.com",
    "message_count": 25,
    "unread_count": 10,
    "last_message_at": "2024-12-25T10:00:00Z",
    "last_message_direction": "inbound",
    "last_inbound_at": "2024-12-25T10:00:00Z",
    "snippet": "example_string",
    "created_at": "2024-12-25T10:00:00Z",
    "updated_at": "2024-12-25T10:00:00Z"
  },
  "messages": [
    {
      "id": "example_string",
      "direction": "inbound",
      "kind": "example_string",
      "status": "example_string",
      "message_id": "example_string",
      "from": {
        "name": "John Doe",
        "email": "user@example.com"
      },
      "to": [
        {
          "name": "John Doe",
          "email": "user@example.com"
        }
      ],
      "cc": [
        {
          "name": "John Doe",
          "email": "user@example.com"
        }
      ],
      "subject": "example_string",
      "snippet": "example_string",
      "body_text": "example_string",
      "body_html": "example_string",
      "reply_text": "example_string",
      "reply_html": "example_string",
      "attachments": [
        {
          "index": 42,
          "filename": "John Doe",
          "content_type": "example_string",
          "size": 42,
          "is_inline": true,
          "content_id": "example_string"
        }
      ],
      "is_read": true,
      "date": "2024-12-25T10:00:00Z",
      "email_job_id": "user@example.com"
    }
  ]
}

GET

/v1/inbox/threads/{id}

GET

Base URLstring

Target server for requests. Edit to use your own host.

API Key (header: X-API-Key)

X-API-Keystring

Required

API key in the format sk_live_<64 hex characters>

path

idstring

Required

MongoDB ObjectID

Request Preview

Response

Response will appear here after sending the request

Authentication

header

X-API-Keystring

Required

API Key for authentication. API key in the format sk_live_\<64 hex characters\>

Path Parameters

idstring

Required

MongoDB ObjectID

Example:

507f1f77bcf86cd799439011

Responses

threadobject

messagesarray

Was this page helpful?

{ "thread": { "id": "example_string", "mailbox_id": "example_string", "root_message_id": "example_string", "subject": "example_string", "participants": [ "example_string" ], "email_job_id": "user@example.com", "message_count": 25, "unread_count": 10, "last_message_at": "2024-12-25T10:00:00Z", "last_message_direction": "inbound", "last_inbound_at": "2024-12-25T10:00:00Z", "snippet": "example_string", "created_at": "2024-12-25T10:00:00Z", "updated_at": "2024-12-25T10:00:00Z" }, "messages": [ { "id": "example_string", "direction": "inbound", "kind": "example_string", "status": "example_string", "message_id": "example_string", "from": { "name": "John Doe", "email": "user@example.com" }, "to": [ { "name": "John Doe", "email": "user@example.com" } ], "cc": [ { "name": "John Doe", "email": "user@example.com" } ], "subject": "example_string", "snippet": "example_string", "body_text": "example_string", "body_html": "example_string", "reply_text": "example_string", "reply_html": "example_string", "attachments": [ { "index": 42, "filename": "John Doe", "content_type": "example_string", "size": 42, "is_inline": true, "content_id": "example_string" } ], "is_read": true, "date": "2024-12-25T10:00:00Z", "email_job_id": "user@example.com" } ] }