Plan & Trial
Read live plan, quota, and upgrade info for a key, and start the self-serve no-card trial via the MisarBlog API.
These endpoints expose the authenticated key's current plan and quota usage, and drive the self-serve trial. They back the MCP upgrade tool. All are available to any authenticated mbk_ key (no scope required).
Get plan & quota
/planReturns the live plan, per-feature quota usage, and upgrade information for the authenticated key.
Response fields
plan{ slug: string; name: string }The active plan's slug and display name.
usageArray<UsageRow>Per-feature usage. Each row has feature, feature_label, used, limit, remaining, period, and resets_at (ISO 8601).
upgradeobjectUpgrade guidance — the higher plan and checkout entry point surfaced to the caller.
curl https://api.misar.io/blog/v1/plan \
-H "Authorization: Bearer mbk_YOUR_KEY"{
"plan": { "slug": "free", "name": "Free" },
"usage": [
{
"feature": "articles_published",
"feature_label": "Articles published",
"used": 3,
"limit": 10,
"remaining": 7,
"period": "month",
"resets_at": "2026-09-01T00:00:00Z"
}
],
"upgrade": {}
}Get trial status
/trialReturns self-serve, no-card trial eligibility and status for the authenticated creator.
Response fields
eligiblebooleanWhether the caller can start a trial.
activebooleanWhether a trial is currently running.
ends_atstringISO 8601 end time of the active trial (null when not active).
plan_slugstringThe plan granted for the trial.
daysintegerTrial length in days.
requires_cardbooleanAlways false for the self-serve trial.
reasonstringWhen eligible is false, a human-readable reason.
curl https://api.misar.io/blog/v1/trial \
-H "Authorization: Bearer mbk_YOUR_KEY"{
"eligible": true,
"active": false,
"ends_at": null,
"plan_slug": "pro",
"days": 14,
"requires_card": false,
"reason": ""
}Start a trial
/trialStarts the self-serve, no-card trial. Tightly rate-limited to 5 requests per hour.
Request body
featurestringbodyThe feature that prompted the trial (used for attribution in the upsell funnel).
refstringbodyOptional referrer / entry-point tag.
curl -X POST https://api.misar.io/blog/v1/trial \
-H "Authorization: Bearer mbk_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{ "feature": "ai_titles", "ref": "editor" }'{}Status codes
401— Missing or invalid key429— Rate limit exceeded (100 req/min per key; trial start additionally capped at 5/hour)500— Unexpected server error
See Errors for the full reference.