GET accounts/email

Get Account Configuration

November 17, 2025 (June 15, 2026)

Request Headers
Path Parameters
Responses
Model
Examples
Try It

Get configuration details for a specific Google Flow account, including health status, credits information, and available video models.

https://api.useapi.net/v1/google-flow/accounts/email

Request Headers

Authorization: Bearer {API token}

API token is required, see Setup useapi.net for details.

Path Parameters

email is required. The email address of the Google Flow account to query (URL-encoded if necessary).

Responses

200 OK

Account configuration found and returned with health status.

{
  "created": "2025-11-10T12:00:00.000Z",
  "accountCookies": [
    {
      "name": "HSID",
      "value": "AYQ...(redacted)",
      "domain": ".google.com",
      "path": "/",
      "expires": "2027-11-10T12:00:00.000Z",
      "httpOnly": true,
      "secure": false,
      "sameSite": "Lax"
    }
  ],
  "sessionCookies": [
    {
      "name": "__Host-GAPS",
      "value": "1:eJy...(redacted)",
      "domain": "labs.google",
      "path": "/",
      "expires": "2025-12-10T12:00:00.000Z",
      "httpOnly": true,
      "secure": true,
      "sameSite": "Lax"
    }
  ],
  "sessionData": {
    "user": {
      "name": "John Doe",
      "email": "jo***@gmail.com",
      "image": "https://lh3.googleusercontent.com/a/..."
    },
    "expires": "2025-11-11T12:00:00.000Z",
    "access_token": "ya29.a0A...(redacted)"
  },
  "project": {
    "projectId": "3b1c0e9d-7a6f-4592-8d38-7f9e1b4c6a5d",
    "projectTitle": "Nov 11 - 02:56"
  },
  "nextRefresh": {
    "messageId": "msg-abc123",
    "scheduledFor": "2025-11-11T11:00:00.000Z"
  },
  "health": "OK",
  "credits": {
    "credits": 1250,
    "userPaygateTier": "PAYGATE_TIER_TWO"
  },
  "models": {
    "videoModels": [
      {
        "key": "veo_3_1_t2v",
        "displayName": "Veo 3.1 - Quality",
        "supportedAspectRatios": ["VIDEO_ASPECT_RATIO_LANDSCAPE"],
        "capabilities": ["VIDEO_MODEL_CAPABILITY_AUDIO", "VIDEO_MODEL_CAPABILITY_TEXT"],
        "videoLengthSeconds": 8,
        "videoGenerationTimeSeconds": 240,
        "creditCost": 100,
        "framesPerSecond": 24,
        "paygateTier": "PAYGATE_TIER_TWO",
        "accessType": "MODEL_ACCESS_TYPE_GENERAL",
        "modelAccessInfo": {},
        "modelMetadata": {
          "veoModelName": "Beta Audio"
        }
      },
      {
        "key": "veo_3_1_t2v_lite_low_priority",
        "displayName": "Veo 3.1 - Lite [Lower Priority]",
        "supportedAspectRatios": ["VIDEO_ASPECT_RATIO_LANDSCAPE", "VIDEO_ASPECT_RATIO_PORTRAIT"],
        "capabilities": ["VIDEO_MODEL_CAPABILITY_AUDIO", "VIDEO_MODEL_CAPABILITY_TEXT"],
        "videoLengthSeconds": 8,
        "videoGenerationTimeSeconds": 110,
        "creditCost": 0,
        "framesPerSecond": 24,
        "paygateTier": "PAYGATE_TIER_TWO",
        "accessType": "MODEL_ACCESS_TYPE_GENERAL",
        "modelAccessInfo": {},
        "modelMetadata": {
          "veoModelName": "Beta Audio"
        }
      }
    ]
  }
}

Note: Sensitive values (cookie values, access tokens) are redacted for security. Email addresses are partially masked.

The credits and models fields are only included when health is "OK".

Captcha provider recommendations. When fewer than two captcha providers are configured on the account, the response also includes a top-level recommendations array. Single-provider users have no failover when Google’s reCAPTCHA Enterprise scores a token low — adding a second provider lets the worker rotate on failure and dramatically reduces captcha_quality: 429s / 403s. Example:

{
  "health": "OK",
  "credits": {...},
  "models": {...},
  "recommendations": [
    "Only one captcha provider configured. Adding a second provider gives the worker a fallback when Google scores a token low — significantly reduces 429 TOO_MUCH_TRAFFIC and 403 captcha errors. Configure via POST /accounts/captcha-providers."
  ]
}

The field is omitted when you already have two or more providers configured. Configure additional providers via POST /accounts/captcha-providers.

Free models on Ultra: For accounts with Google AI Ultra subscription (PAYGATE_TIER_TWO), video models with creditCost: 0 are free to generate. These are the lower-priority variants — keys ending in _low_priority (e.g. veo_3_1_t2v_lite_low_priority). Keys ending in _ultra are discounted but not free — they typically cost 10 credits per generation.

401 Unauthorized

Invalid API token.
```
{
  "error": "Unauthorized"
}
```

404 Not Found

Account not found or not configured.

{
  "error": "Google Flow account [email protected] not found"
}

Model

{
  created: string              // ISO 8601 timestamp
  accountCookies: Array<{
    name: string
    value: string              // Redacted
    domain: string
    path: string
    expires: string | number
    httpOnly: boolean
    secure: boolean
    sameSite: 'Lax' | 'Strict' | 'None'
  }>
  sessionCookies: Array<{      // Same structure
    name: string
    value: string              // Redacted
    domain: string
    path: string
    expires: string | number
    httpOnly: boolean
    secure: boolean
    sameSite: 'Lax' | 'Strict' | 'None'
  }>
  sessionData: {
    user: {
      name: string
      email: string            // Partially masked
      image: string
    }
    expires: string            // ISO 8601 timestamp
    access_token: string       // Redacted
  }
  project: {
    projectId: string
    projectTitle: string
  }
  nextRefresh: {
    messageId: string
    scheduledFor: string       // ISO 8601 timestamp
  }
  health: string               // "OK" | "<error>"
  credits?: {                  // Only present when health is "OK"
    credits: number
    userPaygateTier: string    // "PAYGATE_TIER_ZERO" | "PAYGATE_TIER_ONE" | "PAYGATE_TIER_TIER1P5" | "PAYGATE_TIER_TWO"
  }
  models?: {                   // Only present when health is "OK"
    videoModels: Array<{
      key: string              // Model identifier (e.g., "veo_3_1_t2v_fast_ultra")
      displayName: string      // "Veo 3.1 - Fast" | "Veo 3.1 - Quality" | "Veo 3.1 - Lite" | "Veo 3.1 - Lite [Lower Priority]" | ...
      supportedAspectRatios: string[]
      capabilities: string[]   // e.g., ["VIDEO_MODEL_CAPABILITY_TEXT", "VIDEO_MODEL_CAPABILITY_AUDIO"]
      videoLengthSeconds: number
      videoGenerationTimeSeconds?: number
      creditCost: number       // Credits charged per generation. 0 for free Ultra-only variants (`_low_priority`, `_relaxed`).
      framesPerSecond: number
      paygateTier: string      // "PAYGATE_TIER_ZERO" | "PAYGATE_TIER_ONE" | "PAYGATE_TIER_TIER1P5" | "PAYGATE_TIER_TWO"
      accessType: string
      modelAccessInfo: object
      modelMetadata: object
    }>
  }
  error?: string               // Error message
}

Examples

curl -H "Authorization: Bearer YOUR_API_TOKEN" \
     "https://api.useapi.net/v1/google-flow/accounts/john%40gmail.com"

import requests
from urllib.parse import quote

token = 'YOUR_API_TOKEN'
email = '[email protected]'

headers = {'Authorization': f'Bearer {token}'}

response = requests.get(
    f'https://api.useapi.net/v1/google-flow/accounts/{quote(email)}',
    headers=headers
)

account_config = response.json()
print('Account config:', account_config)
print('Health:', account_config.get('health'))
print('Credits:', account_config.get('credits'))

const token = 'YOUR_API_TOKEN';
const email = '[email protected]';

const response = await fetch(
  `https://api.useapi.net/v1/google-flow/accounts/${encodeURIComponent(email)}`,
  {
    headers: {
      'Authorization': `Bearer ${token}`
    }
  }
);

const accountConfig = await response.json();
console.log('Account config:', accountConfig);
console.log('Health:', accountConfig.health);
console.log('Credits:', accountConfig.credits);