Get one account

June 3, 2026

Table of contents

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

Get the detail for a single configured account.

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

  • email is the account’s email address (URL-encoded in the path).

Request Headers 

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

Responses

  • 200 OK

    {
  "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",
  "credits_remaining": 5000,
  "tokens_remaining": 60000
}
    • credits_remaining and tokens_remaining are live-pulled from Flow Music on every request, so they are always current. They are returned only for a healthy account — an account in an error state (error present) omits them because its balance can’t be queried.

  • 401 Unauthorized — invalid API token.

  • 404 — account not configured.

Model 

{
  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
  credits_remaining?: number | null    // live-pulled per request; present only for a healthy account
  tokens_remaining?: number | null     // live-pulled per request; present only for a healthy account
}

Examples 

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

  • import requests, urllib.parse
email = '[email protected]'
r = requests.get('https://api.useapi.net/v1/flowmusic/accounts/' + urllib.parse.quote(email, safe=''),
                 headers={'Authorization': 'Bearer YOUR_API_TOKEN'})
print(r.status_code, r.json())

Try It