List All Configured Accounts

February 23, 2026 (November 16, 2026)

Table of contents

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

List all configured Dreamina accounts.

To get a specific account with live details use GET /accounts/account.

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

Request Headers

Authorization: Bearer {API token}

Responses

  • 200 OK

    Returns a map of all configured accounts, keyed by account identifier.

    {
      "US:user@example.com": {
        "account": "US:user@example.com",
        "email": "user@example.com",
        "region": "US",
        "maxJobs": 10,
        "sessionExpires": "2026-04-24T12:00:00.000Z"
      }
    }
    

    If no accounts are configured, the answer is 404 with no body.

    An account in its sign-out pause also carries signedOutPauseUntil, and a marked account carries error:

    {
      "US:user@example.com": {
        "account": "US:user@example.com",
        "email": "user@example.com",
        "region": "US",
        "maxJobs": 10,
        "sessionExpires": "2026-04-24T12:00:00.000Z",
        "signedOutPauseUntil": "2026-11-01T18:30:00.000Z"
      }
    }
    

    When Dreamina signs an account out again right after a fresh sign-in, the account is paused for 30 minutes. While the pause runs, GET /accounts shows signedOutPauseUntil (an ISO 8601 time) on that account, requests that name it answer 596, and automatic account selection uses your other accounts. When every account is paused, requests answer 596. After the pause the account is used again. If Dreamina signs it out right after a fresh sign-in again, after the pause and within 24 hours, the account is marked with an error and answers 596 until you re-add it with POST /accounts. Re-adding an account also ends its pause.

    A sign-in that fails for a temporary reason, not because Dreamina refused the account, answers 503 with a Retry-After: 30 header. The account is fine: retry in about 30 seconds.

  • 401 Unauthorized

    Invalid API token.

    {
      "error": "Unauthorized"
    }
    

Model

An object keyed by account identifier, such as US:user@example.com, each value with its region, maxJobs and session expiry.

The accounts, keyed by account id, field by field
// Map of account identifier to account summary
{
  [account: string]: {
    account: string              // "US:user@example.com"
    email: string
    region: string               // "US"
    maxJobs: number
    sessionExpires: string       // ISO 8601 timestamp
    error?: string               // Error message if account has issues; the account answers 596 until re-added
    signedOutPauseUntil?: string // ISO 8601 timestamp, only while the account's sign-out pause runs
  }
}

Examples

  • curl -H "Authorization: Bearer YOUR_API_TOKEN" \
         "https://api.useapi.net/v1/dreamina/accounts"
    
  • const token = 'YOUR_API_TOKEN';
    
    const response = await fetch('https://api.useapi.net/v1/dreamina/accounts', {
      headers: {
        'Authorization': `Bearer ${token}`
      }
    });
    
    const accounts = await response.json();
    console.log('Configured accounts:', accounts);
    
  • import requests
    
    token = 'YOUR_API_TOKEN'
    headers = {'Authorization': f'Bearer {token}'}
    
    response = requests.get('https://api.useapi.net/v1/dreamina/accounts', headers=headers)
    print('All accounts:', response.json())
    

Try It