Posttar API

Plan

1 endpoint for plan, with parameters and a real response example.

View as MarkdownOpen in ClaudeOpen in ChatGPT

GET/plan

Get the plan and quote a change

The workspace's plan (posts per month, Instagram accounts, billing period, currency, what the next renewal charges, trial end), the posts available right now, and the price table in the plan's currency: the 4, 12 and 30 post tiers, monthly and annual, and the one-time post packs. plan is null when the workspace never subscribed. Send posts, accounts or period to quote a change: target is the new price, and change.kind predicts how it would happen (upgrade_now charges the prorated difference and adds creditsNow posts, at_period_end applies at renewal, trial_swap switches during the trial, noop is the same plan). The prediction is final only at checkout. changeBlockedBy says why a change can't be made from the app right now. Read-only: changing plan and buying packs happen in the app, at links.changePlan and links.buyPack. Amounts are in cents.

ParameterInTypeDescription
postsqueryinteger1 to 999Posts per month to quote a change to, 1 to 999. Up to 30 it rounds up to the next tier (4, 12, 30). Omit all three to read the plan without a quote.
accountsqueryinteger1 to 60Instagram accounts to quote, 1 to 60. Defaults to the current plan's.
periodquery"monthly" | "annual"Billing period to quote. Defaults to the current plan's.

Response

{
  "plan": {
    "name": "pro",
    "status": "active",
    "posts": 30,
    "accounts": 1,
    "period": "monthly",
    "currency": "BRL",
    "renewalCents": 29900,
    "listPriceCents": 29900,
    "isLegacyPrice": false,
    "trialEndsAt": null,
    "currentPeriodEnd": "2026-11-06T12:00:00+00:00",
    "cancelAtPeriodEnd": false,
    "hasEverPaid": true,
    "billedManually": false