Docs menu
API reference

Account

Who you are: business, plan, credits, channels.

Account overview

GET/v1/public/account
scopesaccount:read

Business profile, plan, credit balance, channel summary, and autopilot state.

request
curl https://api.taka.ai/v1/public/account \
  -H "Authorization: Bearer taka_live_..."
response
{
  "businessId": "abc123",
  "businessName": "Sunrise Bakery",
  "onboardingComplete": true,
  "plan": {
    "tier": "pro",
    "billingPeriod": "monthly",
    "renewsAt": "2026-09-01T09:30:00Z",
    "hasActiveSubscription": true
  },
  "credits": {
    "subscriptionCredits": 1200,
    "topUpCredits": 300,
    "totalCredits": 1500
  },
  "channels": [
    {
      "platform": "instagram",
      "displayName": "Instagram",
      "connected": true,
      "account": "@sunrisebakery",
      "available": true,
      "needsReconnect": false,
      "restricted": false,
      "connectedAt": "2026-09-01T09:30:00Z"
    }
  ],
  "activeAutopilotPlans": 1
}

Credit balance

GET/v1/public/account/credits
scopesaccount:read

The live credit balance. Generation draws credits; edits, scheduling, and publishing are free.

request
curl https://api.taka.ai/v1/public/account/credits \
  -H "Authorization: Bearer taka_live_..."
response
{
  "subscriptionCredits": 1200,
  "topUpCredits": 300,
  "totalCredits": 1500
}