Categorize Stats

Retrieve per-category counts for the unified inbox.

GEThttps://api.foxreach.io/api/v1/inbox/categorize-stats

Returns the number of threads in each AI category plus totals, scoped to the authenticated workspace. Useful for building dashboards and monitoring reply volumes without paginating through threads.

Response#

dataobject

Show Categorize stats object

totalinteger

Total number of reply threads in the inbox.

unreadinteger

Number of unread threads.

interestedinteger

Threads categorized as interested.

not_interestedinteger

Threads categorized as not_interested.

out_of_officeinteger

Threads categorized as out_of_office.

bounceinteger

Threads categorized as bounce.

unsubscribeinteger

Threads categorized as unsubscribe.

uncategorizedinteger

Threads not yet categorized.

unknowninteger

Threads from unknown senders.

unrelatedinteger

Threads categorized as unrelated.

Rate Limit#

100 requests per minute, per API key. Fixed 60-second window.
Every response includes X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset (unix epoch seconds).
A 429 response includes a Retry-After header (seconds until the bucket resets).

For client-side patterns, see Rate Limiting.

Request

curl -X GET "https://api.foxreach.io/api/v1/inbox/categorize-stats" \
  -H "X-API-Key: otr_your_key"

from foxreach import FoxReach

client = FoxReach(api_key="otr_your_key")
stats = client.inbox.categorize_stats()

import { FoxReach } from "foxreach";

const client = new FoxReach({ apiKey: "otr_your_key" });
const stats = await client.inbox.categorizeStats();

Response

{
  "data": {
    "total": 142,
    "unread": 23,
    "interested": 45,
    "not_interested": 38,
    "out_of_office": 12,
    "bounce": 4,
    "unsubscribe": 3,
    "uncategorized": 8,
    "unknown": 16,
    "unrelated": 5
  }
}

Was this page helpful?

View as MarkdownLast updated November 2, 2026