Skip to main content
GET
/
api
/
v1
/
accounts
List all accounts with subscription and entitlements
curl --request GET \
  --url https://www.suprsonic.com/api/v1/accounts \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "5deaa894-2094-4da3-b4fd-1fada0809d1c",
      "name": "Acme Corp",
      "slug": "acme-corp",
      "picture_url": null,
      "email": "[email protected]",
      "is_personal_account": false,
      "created_at": "2024-01-15T10:30:00Z",
      "updated_at": "2024-02-01T15:45:00Z",
      "subscription": {
        "status": "active",
        "plan_variant": "growth_plan",
        "plan_name": "Growth Plan"
      },
      "entitlements": {
        "content_generation": {
          "generation_days": [
            "monday",
            "thursday"
          ],
          "articles_per_week": 2,
          "articles_per_month": 8,
          "can_generate_today": true
        },
        "social_media": {
          "platforms": [
            "twitter",
            "linkedin"
          ],
          "twitter_posts_per_week": 14,
          "linkedin_accounts": 2
        },
        "api_limits": {
          "requests_per_month": 50000,
          "rate_limit_per_minute": 300
        }
      }
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 42,
    "has_more": true
  }
}
Admin API Key Required - This endpoint requires an admin API key for access. Only system administrators can list all accounts across the platform.

​
Content Generation System

This endpoint is designed for third-party content generation systems. The response includes all business logic needed to determine:
  • Which accounts can generate content today
  • How many articles per week/month each account is entitled to
  • What days of the week content should be generated
  • Current subscription status and plan information

Authorizations

​
Authorization
string
header
required

Admin API key for managing accounts and creating content

Query Parameters

​
status
enum<string>

Filter accounts by subscription status (active = has active/trialing subscription, inactive = no active subscription)

Available options:
active,
inactive
​
content_eligible
boolean

Filter to only accounts eligible for content generation today

​
q
string

Search accounts by name or slug

​
page
integer
default:1

Page number for pagination

Required range: x >= 1
​
limit
integer
default:20

Number of accounts per page

Required range: 1 <= x <= 100

Response

Successfully retrieved accounts with enhanced subscription and entitlements data

​
data
object[]
​
pagination
object