Skip to content

Categorize Stats

Retrieve per-category counts for the unified inbox.

GET/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#

  • 600 requests per minute, shared by every poll call in your workspace. Fixed 60-second window.
  • Every response includes X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset (unix epoch seconds) and X-RateLimit-Bucket (poll).
  • A 429 response includes a Retry-After header (seconds until the bucket resets).

For client-side patterns, see Rate Limiting.

Was this page helpful?
View as MarkdownLast updated November 6, 2026