List accounts

June 3, 2026 (November 7, 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).
    • tier is the account’s Flow Music plan, re-read when the account’s login refreshes (about hourly while the account is in use). GET /accounts/email re-reads it at once, and a new plan also moves maxJobs to that plan’s default unless you set maxJobs yourself with POST /accounts. The plan included with Google AI Plus, Pro or Ultra reads as starter, plus or member.
    • 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