Get plan and usage
Billed per connected account, the first 2 free. Only keys and people that reach every profile see it, since the plan counts every profile's accounts.
apiKeyAuthorizationBearer <token>An API key from the web app, under Developers. It starts with rz_live_.
OK
application/json- response
status*stringfree: up to 2 accounts, no card. active: a paid plan. past_due: a payment failed and Stripe retries it for up to 14 days; everything works. unpaid: still unpaid after 14 days, so accounts beyond 2 are paused until it is paid. cancelling: the plan ends at periodEnd, then the team is on the free plan.
"free""active""past_due""unpaid""cancelling"interval*|Monthly or yearly; null on the free plan.
accounts*price*periodEnd*|When the period ends: the next renewal, or the end of a plan that is cancelling.
apiCap*What an owner lets connect links add on a paid plan (ADR 0025).
action*|What a team owner must do in the web app, if anything. checkout: accounts wait for a paid plan to start, or more accounts are active than the free plan keeps (connected before billing was on), and the newest pause at the daily check (04:00 UTC) unless a plan starts. pay: an added account's charge needs the card holder (3-D Secure) or failed. update_card: a renewal failed. choose_accounts: the plan ended or went unpaid, and the owner may pick which 2 accounts stay active.
curl -X GET 'https://api.rizamo.com/v1/billing'{ "status": "active", "interval": "month", "accounts": { "connected": 4, "active": 4, "awaitingPayment": 0, "paused": 0, "billed": 4, "free": 2 }, "price": { "perPeriod": 10, "nextAccount": 5, "discountPercent": null, "currency": "usd" }, "periodEnd": "2026-12-01T00:00:00.000Z", "apiCap": { "accounts": null, "added": 0 }, "action": null}Get the audience GET
Each account's audience as last read: its followers, and the people who engaged with its content this month, by age, gender, country and city (YouTube without city), and when its followers are active, by the hour in UTC (`activeHours`), from TikTok, for accounts with advanced access or a verified business account, and 100 followers or more. Rizamo reads it once a week for Instagram, TikTok, Threads and YouTube accounts (Instagram through either login). Followers come only for accounts with 100 followers or more. Instagram gives the engaged audience only when each group has more than 100 people; TikTok and Threads give none; YouTube gives no followers (`followers` is null). A YouTube channel's engaged audience is its viewers this month (last month until the 8th, as YouTube's numbers come 2 to 3 days late), counted by their views. Facebook no longer gives a Page's audience, and other networks are not read yet: their accounts come with why.
List events GET
Every change on the team's posts and accounts in the last 30 days, newest first, with who made it: a person, an API key, an agent, or Rizamo itself; and the inbox's comments and messages as they arrive, the replies sent from Rizamo, and what comment automations do. The same events webhooks send, each as one item of this list. A page at a time: pass `nextCursor` as `cursor` for the next one. Someone limited to some profiles sees only those profiles' events. The inbox's and comment automations' events carry what people wrote: a key or agent reads them only with `inbox:read` (`comment.received`, `message.received`, `message.sent`) or `automations:read` (`comment_automation.*`) too; asking for one of those types without it answers 403.