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.

​
Enhanced Response

This endpoint now returns comprehensive account information including:
  • Subscription Status: Current plan and subscription state
  • Plan Entitlements: Content generation limits, social media capabilities, language support
  • Business Logic: Real-time eligibility checks (e.g., “can generate content today”)

​
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

​
Filtering Options

  • status=active: Accounts with active or trialing subscriptions
  • status=inactive: Accounts without active subscriptions
  • content_eligible=true: Accounts that can generate content today
  • q=search: Search by account name or slug

​
Example Response

Each account includes entitlements data like this: 
{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "Acme Corporation",
  "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
    }
  }
}

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