# Billing and usage

> Plans, the connected-account allowance, usage, X API pass-through credits, invoices and billing webhooks.

Billing is mostly managed in the app (**Manage → Billing**). The API exposes everything you need to read state and react to it, in the [Billing](/docs/api-reference/billing/) reference (MCP toolset `billing`). Reads need the `owner`, `admin` or `billing` role, or any API key with `read`. Checkout, plan changes, payment methods and the customer portal are dashboard-only.

## Plans

| Plan | Price | Accounts included | Extra account | API requests per hour |
|---|---|---|---|---|
| Free | $0 | 3 | – | 600 |
| Pro | $25/mo ($20/mo yearly) | 25 | $2/mo | 6,000 |
| Business | $250/mo ($200/mo yearly) | 250 | $1/mo | 30,000 |
| Enterprise | Custom | Unlimited | Custom | 120,000+ |

Posts are unlimited on every plan. Features such as broadcasts, automations, ads and hosted connect are plan-gated. `GET /v1/billing/plans` returns every plan with its features and limits.

## Allowance and usage

```bash
curl https://api.socialit.com/v1/usage -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

`GET /v1/usage` returns connected accounts against the allowance, the current API request window, media storage and other metered limits. The **account allowance** is the plan's included accounts plus purchased extra accounts (plus lifetime seats on legacy deals).

When a workspace ends up over its allowance (after a downgrade or cancellation), accounts stay connected but publishing pauses on the newest accounts beyond it, and `billing.accounts_over_limit` fires. `GET /v1/billing` returns `publishing_paused` and a `banner` you can show.

## Plan errors

| Error | When |
|---|---|
| `403 plan_limit_error` / `plan_required` | The operation needs a feature your plan doesn't have (`required_plan` says which) |
| `403 plan_limit_error` / `account_limit_reached` | Connecting would exceed the allowance (`usage: { used, limit, requested }`) |
| `402 plan_limit_error` / `insufficient_credits` | X API calls without prepaid credits |
| `403 plan_limit_error` / `analytics_history_limit` | Analytics older than your plan's history window |

## X API credits

X charges per API call. Socialit passes that cost through from prepaid credits: `GET /v1/billing/x-pricing` shows the price table, `GET /v1/billing/credits` the balance and packs, and `GET /v1/usage/x-api` the usage per day, account and endpoint. Postings record `credits_charged`.

## Invoices and previews

`GET /v1/billing/invoices` (filter by `status`) and `…/{id}` return invoices. `GET /v1/billing/preview?plan=business&interval=year&extra_accounts=10` previews a plan change with proration before you make it in the app.

## Webhooks

`billing.subscription_created`, `billing.subscription_updated`, `billing.subscription_canceled`, `billing.invoice_paid`, `billing.payment_failed`, `billing.credits_purchased` and `billing.accounts_over_limit`. See [Billing events](/docs/api-reference/webhook-events/#events-billing).

---

Source: https://socialit.com/docs/billing-usage/
