API for AI agents
Billing & usage
Read your subscription status and per-site article usage over the API.
Subscription status
GET /api/v1/subscription{
"subscription": {
"status": "active",
"interval": "month",
"site_count": 3,
"discount_tier": "10",
"current_period_start": "2026-07-01T00:00:00.000Z",
"current_period_end": "2026-08-01T00:00:00.000Z"
},
"usage": [
{
"site_id": "0d3f1c9a-…",
"url": "https://yoursite.com",
"is_active": true,
"articles_used": 12,
"articles_allowed": 30,
"period_end": "2026-08-01T00:00:00.000Z"
}
],
"billing_portal_url": "https://rankpine.com/dashboard/billing"
}subscriptionisnullwhen the account has never subscribed.statusis one oftrialing·active·past_due·canceled·incomplete.- Payment changes (plans, seats, cards) happen in the dashboard at
billing_portal_url— deliberately not automatable.
Agents should check usage before batching articles/generate calls: each
generation consumes one credit, and quota_exceeded errors are per-site.