Check Your Prepaid API Credit Balance API

Returns the current API credit balance for the authenticated account. Free to call. Agents should check the balance before starting large batch jobs and surface "insufficient_credits" errors to the user with a link to top up.

A free endpoint that returns the authenticated account's current API credit balance. Billing is prepaid (1 credit = $0.01), and every billable call draws down the balance, so this is the number an agent checks before committing to a large batch of work. It never costs credits to read.

How to call it

GET /api/v1/credits. Authenticate with your API key. Same call in three languages:

curl -X GET "https://viraloutliers.com/api/v1/credits" \
  -H "Authorization: Bearer so_live_YOUR_KEY"

import requests

r = requests.get(
"https://viraloutliers.com/api/v1/credits",
    headers={"Authorization": "Bearer so_live_YOUR_KEY"},
)
print(r.json())

const res = await fetch("https://viraloutliers.com/api/v1/credits", {
  method: "GET",
  headers: { "Authorization": "Bearer so_live_YOUR_KEY" },
});
const data = await res.json();
console.log(data);

Pricing

This skill is free and never spends credits.

Agent workflows

• Budget guard: check balance before a batch run → cap the batch to the credits available.

Frequently asked questions