List Muse accounts

October 12, 2026

Table of contents

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

List the Muse accounts added with POST /accounts. Each entry shows the account’s health, its maxJobs, when its session expires, and its plan and weekly usage as last read.

This endpoint does not call Muse. For the live plan and usage use GET /accounts/email. GET /jobs shows how many jobs each account is running.

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

Request Headers 
Authorization: Bearer {API token}
Responses

  • 200 OK

    {
  "[email protected]": {
    "email": "[email protected]",
    "maxJobs": 3,
    "added": "2026-10-12T00:34:19.139Z",
    "updated": "2026-10-12T01:29:14.234Z",
    "sessionExpiresAt": "2026-11-11T00:34:18.820Z",
    "quota": {
      "tier": "HATCH_FREE",
      "percentUsed": 0,
      "resetsAt": "2026-10-19T01:13:05.000Z",
      "quotaStatus": "SUFFICIENT",
      "topupBalance": 0,
      "readAt": "2026-10-12T01:13:05.614Z"
    },
    "health": "OK"
  }
}
    • The response is an object keyed by account email, or {} when no account is added.
    • health is OK, or the reason the account needs attention. Such an account is paused: it takes no new jobs until you add it again with POST /accounts. See Setup Muse.
    • quota is updated when the account is added, on every GET /accounts/email, and when Muse refuses a job.

  • 401 Unauthorized

    Invalid API token.

    {
  "error": "useapi.net ⁝ Unauthorized",
  "code": 401
}
Model 
{ // TypeScript, all fields are optional
  [email: string]: {
    email: string
    maxJobs: number                 // jobs this account may run at the same time
    added: string                   // ISO 8601, when the account was first added
    updated?: string                // ISO 8601, the last re-add or maxJobs change
    sessionExpiresAt: string        // ISO 8601, when the Muse session expires (30 days, renewed by the API)
    quota?: {                       // the account's Muse plan and weekly usage, as last read
      tier: string | null           // Muse plan, e.g. HATCH_FREE
      percentUsed: number | null    // share of the weekly allowance used, in whole percent
      resetsAt: string | null       // ISO 8601, when the weekly allowance resets
      quotaStatus: string | null    // SUFFICIENT while jobs may run
      topupBalance: number | null
      readAt: string                // ISO 8601, when this was read from Muse
    }
    health: string                  // 'OK', or why the account needs attention (596)

  }
}
Examples 
  • curl "https://api.useapi.net/v1/muse/accounts" \
   -H "Authorization: Bearer …"

  • const token = "API token";
const apiUrl = "https://api.useapi.net/v1/muse/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/muse/accounts"
headers = {
    "Authorization" : f"Bearer {token}"
}
response = requests.get(apiUrl, headers=headers)
print(response, response.json())
Try It