Billing API

GET /v1/billing/status

Get Billing Status

Current plan, billing status and quota usage for the workspace.

calls_used counts the pins published successfully this month (calendar month,
UTC) against quota_calls_monthly, and quota_reset_at is when it resets.
Only successful new pins count, scheduled pins included when they publish;
reads, failures and retries don’t. Once the quota is used up, credits are
spent one per pin if credits_enabled; with no quota or credits left,
publishing returns 402 quota_exceeded (or credits_exhausted) while every
other endpoint keeps working.

It also reports usage against the other plan limits (Pinterest accounts, API
keys, weekly AI assistant requests) and, below the top self-serve plan, the
next plan up with its upgrade_url.

The plan value pro is the Agency plan (plan_name). Works with any API key
that has the read scope; a dashboard session needs a role that can manage billing.

Auth: ApiKeyAuth, BearerAuth

Response 200 (BillingStatusResponse)

curl -X GET "https://api.pinbridge.io/v1/billing/status" \
  -H "X-API-Key: $PINBRIDGE_API_KEY"

---