List accounts

June 3, 2026

Table of contents

  1. Request Headers
  2. Responses
  3. Model
  4. Examples
  5. Try It

List all Flow Music accounts configured under your useapi.net account.

https://api.useapi.net/v1/flowmusic/accounts

Request Headers 

Authorization: Bearer {API token}
Content-Type: application/json

Responses

  • 200 OK

    {
  "[email protected]": {
    "email": "[email protected]",
    "tier": "plus",
    "subscription_plan": "plus-monthly",
    "provider": "g1_entitlement",
    "user_id": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
    "maxJobs": 12,
    "added": "2026-06-01T12:00:00.000Z",
    "refreshed_at": "2026-06-01T12:00:00.000Z",
    "refreshed_count": 0,
    "access_token": "eyJ…redacted…zmQ",
    "access_token_expires_at": "2026-06-01T13:00:00.000Z",
    "refresh_token": "l6e…redacted…z4v",
    "session_id": "f0e1d2c3-b4a5-4768-9a0b-1c2d3e4f5a6b"
  }
}
    • The response is an object keyed by account email ({} when no accounts are configured).
    • error is present only when an account needs re-authentication (re-run POST /accounts) — healthy accounts omit it.
    • Credit balances are omitted from the list — fetch them live per account via GET /accounts/email.

  • 401 Unauthorized — invalid API token.

Model

An object keyed by account email ({} when none are configured).

{
  [email: string]: {
    email: string
    tier: 'free' | 'starter' | 'plus' | 'member' | 'unknown'
    subscription_plan?: string         // paid tiers only
    provider?: string                  // paid tiers only
    user_id: string                    // the account's user UUID
    maxJobs: number
    added: string                      // ISO 8601 timestamp
    refreshed_at: string               // ISO 8601 timestamp
    refreshed_count: number
    access_token: string               // redacted
    access_token_expires_at: string    // ISO 8601 timestamp
    refresh_token: string              // redacted
    session_id: string
    error?: string                     // present only when the account needs re-authentication
  }
}

Examples 

  • curl -H "Authorization: Bearer YOUR_API_TOKEN" \
     "https://api.useapi.net/v1/flowmusic/accounts"

  • import requests
r = requests.get('https://api.useapi.net/v1/flowmusic/accounts',
                 headers={'Authorization': 'Bearer YOUR_API_TOKEN'})
print(r.status_code, r.json())

Try It