Get credit balance

curl --request GET \
  --url https://api.magica.com/api/v1/credits/balance \
  --header 'Authorization: <authorization>'

{
  "availableBalance": 123,
  "formatted": "<string>",
  "hasActiveSubscription": true,
  "isOrganization": true
}

GET

credits

balance

Get credit balance

curl --request GET \
  --url https://api.magica.com/api/v1/credits/balance \
  --header 'Authorization: <authorization>'

{
  "availableBalance": 123,
  "formatted": "<string>",
  "hasActiveSubscription": true,
  "isOrganization": true
}

Returns the current credit balance for the authenticated user (or the user’s active organization, if applicable).

Pair this with POST /v1/workflows/estimate-credits or POST /v1/nodes/estimate-credits to confirm there’s enough balance before kicking off an expensive run.

Authorizations

Authorization

string

required

Bearer API key. Format: Bearer gx_your_api_key.

Response

availableBalance

number

Raw credit balance in microcredits. Divide by 1,000,000 to convert to credits. Use formatted if you just need a display string.

formatted

string

Human-readable balance, denominated in millions (e.g. "1.23M").

hasActiveSubscription

boolean

true when the user’s (or org’s) subscription is currently active.

isOrganization

boolean

true when the returned balance belongs to an organization the user is a member of, rather than the user’s personal account.

Request

cURL
Node.js
Python

curl https://api.magica.com/api/v1/credits/balance \
  -H "Authorization: Bearer $MAGICA_API_KEY"

const res = await fetch("https://api.magica.com/api/v1/credits/balance", {
  headers: { Authorization: `Bearer ${process.env.MAGICA_API_KEY}` },
});
const { availableBalance, formatted, hasActiveSubscription } = await res.json();

import os, requests

res = requests.get(
    "https://api.magica.com/api/v1/credits/balance",
    headers={"Authorization": f"Bearer {os.environ['MAGICA_API_KEY']}"},
)
payload = res.json()
print(payload["formatted"])  # e.g. "26.17M"

Response example

{
  "availableBalance": 26170000,
  "formatted": "26.17M",
  "hasActiveSubscription": true,
  "isOrganization": false
}

Errors

Status	Reason
`401`	Missing or invalid API key
`500`	Server error

GET /api/v1/system-workflows/{id}List media generations

​Authorizations

​Response

​Request

​Response example

​Errors

Authorizations

Response

Request

Response example

Errors