Account And Credits - AdSkull API

Use account endpoints before creating expensive jobs so your integration can decide whether to continue, queue later, or ask a user to top up.

Endpoints

Method	Endpoint	Purpose
`GET`	`/v1/account/credits`	Get the remaining AI credit balance and voice quota.
`GET`	`/v1/account/usage`	Get credits, API usage, rate-limit tier, and usage counters.
`GET`	`/v1/account/plan`	Get the current plan and API eligibility.

Credits Response

{
  "object": "account_credits",
  "plan": "creator",
  "api_enabled": true,
  "credits": {
    "total_credits": 420
  },
  "voice_quota": {
    "remaining": 3,
    "limit": 3,
    "simultaneous_limit": 3
  },
  "updated_at": "2026-05-17T12:00:00Z"
}

Usage Response

{
  "object": "account_usage",
  "plan": "creator",
  "api_enabled": true,
  "credits": {
    "total_credits": 420
  },
  "rate_limits": {
    "tier": "standard",
    "requests_per_minute": 60,
    "active_jobs": 3
  },
  "usage": {
    "requests_this_cycle": 238,
    "credits_reserved_this_cycle": 820,
    "credits_refunded_this_cycle": 45,
    "jobs_completed_this_cycle": 31,
    "jobs_failed_this_cycle": 2
  }
}

Possible Errors

HTTP	Code	When it happens
401	`unauthorized`	API key is missing, invalid, expired, or revoked.
403	`plan_required`	API access requires Creator or higher.
403	`billing_issue`	Paid access is paused, expired, disputed, or otherwise not usable.
429	`rate_limited`	Key, account, or IP exceeded rate limits.