List accounts

September 29, 2026

Table of contents

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

---

List the Google accounts connected with POST /accounts. Each entry shows the account’s plan, its health, how many jobs it is running against its maxJobs, and the last usage the API read from Google.

This endpoint does not call Google. For the live plan and usage of one account use GET /accounts/email. The response can be up to 60 seconds old.

https://api.useapi.net/v1/gemini-notebook/accounts

Request Headers

Authorization: Bearer {API token}

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

Responses

• 200
• 401

• 200 OK

  {
    "[email protected]": {
      "email": "[email protected]",
      "tier": "pro",
      "googleTier": "TIER_PRO",
      "googleTierCode": 2,
      "maxJobs": 3,
      "added": "2026-09-27T22:48:12.588Z",
      "cookies": [
        "SID",
        "HSID",
        "SSID",
        "APISID",
        "SAPISID",
        "LSID",
        "OSID",
        "__Secure-OSID"
      ],
      "cookiesExpireAt": "2027-11-01T22:48:08.442Z",
      "addedVia": "setup-browser",
      "limits": {
        "notebooks": 500,
        "sourcesPerNotebook": 300
      },
      "health": "OK",
      "runningJobs": 1,
      "lastKnownQuota": {
        "windows": [
          {
            "window": "5h",
            "resetsAt": "2026-09-28T04:25:40.000Z",
            "usedPercent": 63.11,
            "remainingPercent": 36.89
          },
          {
            "window": "weekly",
            "resetsAt": "2026-10-04T23:25:40.000Z",
            "usedPercent": 3.01,
            "remainingPercent": 96.99
          }
        ],
        "blocked": [
          "cinematic"
        ],
        "at": "2026-09-28T00:09:55.412Z"
      }
    },
    "[email protected]": {
      "email": "[email protected]",
      "tier": "free",
      "googleTier": "TIER_FREE",
      "googleTierCode": 1,
      "maxJobs": 2,
      "added": "2026-09-27T19:18:45.721Z",
      "updated": "2026-09-27T20:11:41.537Z",
      "cookies": [
        "SID",
        "HSID",
        "SSID",
        "APISID",
        "SAPISID",
        "LSID",
        "OSID",
        "__Secure-OSID"
      ],
      "cookiesExpireAt": "2027-11-01T00:00:00.000Z",
      "limits": {
        "notebooks": 100,
        "sourcesPerNotebook": 50
      },
      "health": "Google signed this account out. Re-add it at https://useapi.net/docs/start-here/setup-gemini-notebook",
      "runningJobs": 0
    }
  }
  

  • The response is an object keyed by account email, {} when no account is connected.
  • health is OK for a working account. verifying means Google reported the account as signed out and the API is re-checking it, which takes about a minute. Any other value says why the account must be re-added through POST /accounts or the automated setup. When Google signs an account out, it is paused and you also receive an email with the re-add link.
  • lastKnownQuota is the usage the API last read from Google, at the time given in at. It is refreshed by every GET /accounts/email and after every job, and it is dropped after 5 hours. One-shot requests of POST /artifacts use it to skip accounts where Google would refuse the job.

• 401 Unauthorized

  Invalid API token.

  {
    "error": "useapi.net ⁝ Unauthorized",
    "code": 401
  }
  

Model

An object keyed by account email.

{ // TypeScript, all fields are optional
  [email: string]: {
    email: string
    tier: string                    // Google's plan, short form: 'free' | 'pro' | 'ultra' | 'plus' | … | 'unknown'
    googleTier?: string             // Google's own plan name: 'TIER_FREE' | 'TIER_PRO' | 'TIER_ULTRA' | 'TIER_PLUS' | …
    googleTierCode?: number         // Google's plan code: 1 = Free, 2 = Pro, 3 = Ultra, 4 = Plus, …
    maxJobs: number
    added: string                   // ISO 8601, when the account was first connected
    updated?: string                // ISO 8601, the last re-add or maxJobs change
    cookies: string[]               // names of the stored cookies, never their values
    cookiesExpireAt: string | null  // ISO 8601, the earliest expiry Google stated for the stored cookies
    addedVia?: 'setup-browser'      // present when the account was added by the automated setup
    limits?: {
      notebooks: number | null            // notebooks allowed on the plan
      sourcesPerNotebook: number | null   // sources allowed per notebook
    }
    health: string                  // 'OK', 'verifying', or the reason the account must be re-added
    runningJobs: number             // jobs running on this account now, out of maxJobs
    lastKnownQuota?: {
      windows: {
        window: '5h' | 'weekly'
        resetsAt: string | null     // ISO 8601
        usedPercent: number
        remainingPercent: number
      }[]
      blocked: string[]             // actions Google refused at that time
      at: string                    // ISO 8601, when this usage was read
    }
  }
}

Examples

• Curl
• JavaScript
• Python

• curl "https://api.useapi.net/v1/gemini-notebook/accounts" \
     -H "Authorization: Bearer …"
  

• const token = "API token";
  const apiUrl = "https://api.useapi.net/v1/gemini-notebook/accounts";
  const response = await fetch(apiUrl, {
    headers: {
      "Authorization": `Bearer ${token}`,
    },
  });
  const result = await response.json();
  console.log("response", {response, result});
  

• import requests
  token = "API token"
  apiUrl = "https://api.useapi.net/v1/gemini-notebook/accounts"
  headers = {
      "Authorization" : f"Bearer {token}"
  }
  response = requests.get(apiUrl, headers=headers)
  print(response, response.json())
  

Try It

API Token (see Setup useapi.net)