Skip to main content
GET
/
api
/
v1
/
inbox
/
threads
curl -X GET "https://api.foxreach.io/api/v1/inbox/threads?page=1&pageSize=20&category=interested" \
  -H "X-API-Key: otr_your_key"
{
  "data": [
    {
      "id": "rpl_abc123",
      "fromEmail": "[email protected]",
      "toEmail": "[email protected]",
      "subject": "Re: Quick question about your product",
      "bodyPreview": "Hi, thanks for reaching out! I'd love to learn more about...",
      "category": "interested",
      "isRead": false,
      "isStarred": false,
      "receivedAt": "2025-01-20T14:30:00",
      "leadId": "cld_xyz789",
      "campaignId": "cmp_def456"
    }
  ],
  "meta": {
    "page": 1,
    "pageSize": 20,
    "total": 1,
    "totalPages": 1
  }
}

Query Parameters

page
integer
default:"1"
Page number (starts at 1).
pageSize
integer
default:"20"
Number of threads per page (1-100).
category
string
Filter by AI category: interested, not_interested, out_of_office, uncategorized, unknown, or bounce.
Search across sender email, subject, and body text.

Response

data
array
Array of thread objects.
meta
object
Pagination metadata.
curl -X GET "https://api.foxreach.io/api/v1/inbox/threads?page=1&pageSize=20&category=interested" \
  -H "X-API-Key: otr_your_key"
{
  "data": [
    {
      "id": "rpl_abc123",
      "fromEmail": "[email protected]",
      "toEmail": "[email protected]",
      "subject": "Re: Quick question about your product",
      "bodyPreview": "Hi, thanks for reaching out! I'd love to learn more about...",
      "category": "interested",
      "isRead": false,
      "isStarred": false,
      "receivedAt": "2025-01-20T14:30:00",
      "leadId": "cld_xyz789",
      "campaignId": "cmp_def456"
    }
  ],
  "meta": {
    "page": 1,
    "pageSize": 20,
    "total": 1,
    "totalPages": 1
  }
}