Answers with how many posts, messages and comments your workspace has sent this calendar month (UTC), across all its profiles, against the free plan's allowance. It is read-only and calls no social platform.
On the free plan a workspace can send 1,000 posts, 10,000 messages and
10,000 comments a month, shared by all its profiles. Once the workspace
reaches a limit, sends of that kind
answer 402 usage_limit_reached until the month resets
or a card is added. A workspace with billing set up has no monthly limits, and
its limit fields are null. See Pricing for
what counts as one post, message or comment.
It takes no parameters.
Response
periodstring- The calendar month, as
YYYY-MMin UTC. resetsAtdatetime- When the counts go back to zero: midnight UTC on the 1st of next month.
enforcedboolean- Whether sends past a limit are refused right now.
falsefor a workspace with billing. postsobjectusedthis month and the freelimit, ornullwith billing. A publication to several accounts counts once per account; an X or Bluesky thread counts once.messagesobjectusedandlimitfor direct messages, Instagram private replies and WhatsApp messages sent.commentsobjectusedandlimitfor comments and comment replies Adeli posted.
Sends that fail don't count. Edits, deletes, hiding comments and reading never count.
Errors — 401 unauthorized, 502 database_error.