Usage

The usage endpoint reports your consumption for the current billing period: how many posts you’ve published against your included allotment, any overage, your active plan, and how many social accounts are connected. Paid plans include unlimited connected accounts; the meter is published target-posts.

Get account usage

GET /account/usage

Returns post and account usage for the current calendar-month billing period. The overagecount is the number of published target-posts beyond the active plan’s included allowance, and overage_cost_usduses that plan’s overage rate. On paid plans, social_accounts.limit is null.

Field	Type	Description
`usage.plan.key` / `name`	string	The active pricing plan used for included quota and overage calculation.
`usage.posts.current`	number	Posts published in the current billing period.
`usage.posts.included`	number	Target-posts included in the active plan.
`usage.posts.overage`	number	Published posts beyond the included allotment.
`usage.posts.overage_cost_usd`	number	Overage priced at the active plan’s per-post rate.
`usage.social_accounts.current`	number	Connected accounts.
`usage.alert.threshold_percent`	number \| null	The latest crossed usage alert threshold: `50`, `80`, `100`, or `null`.
`usage.social_accounts.limit`	number \| null	Free has an account cap; paid plans return `null` for unlimited.
`usage.billing_period.start` / `end`	timestamp	The current calendar-month billing window (UTC).

curl

curl https://api.postfuze.com/api/v1/account/usage \
  -H "Authorization: Bearer sk_live_…"

200 OK

{
  "usage": {
    "plan": {
      "key": "team",
      "name": "Team"
    },
    "posts": {
      "current": 1240,
      "included": 10000,
      "overage": 0,
      "overage_cost_usd": 0
    },
    "social_accounts": {
      "current": 18,
      "limit": null
    },
    "alert": {
      "threshold_percent": null
    },
    "billing_period": {
      "start": "2026-06-01T00:00:00.000Z",
      "end": "2026-07-01T00:00:00.000Z"
    }
  }
}

When usage is within the included allotment, overage and overage_cost_usd are 0.