Account

Get your credit balance and recent credit activity

Built for the MCP show_credits tool. This call is free and read only: it never charges, reserves or initializes credits. It carries no links, so unlike the gallery and video routes nothing in it expires after 15 minutes.

  • balance holds available, reserved, lifetime purchased and lifetime used credits. An account with no credit record yet reads as all zeros.
  • transactions lists the newest limit ledger entries. Usage amounts are negative. Each entry carries only uuid, type, amount, balance_after, description and created_at; adjustment and referral entries carry a fixed label instead of their stored text.

Credits belong to no content container, so any one read scope (images:read, videos:read, audio:read, text:read or files:read) admits this route.

get/v1/account/credits

Request

  • Base URL: https://contentmaschine.ai/api
  • URL: https://contentmaschine.ai/api/v1/account/credits
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://contentmaschine.ai/api/oauth/authorize, token URL https://contentmaschine.ai/api/oauth/token)

Query parameters

limitinteger

Recent ledger entries to return. Larger values are clamped; a non-integer is a 400.

Response

The balance and the newest ledger entries.

successboolean
timestampstring date-time

Example response

{
  "success": true
}

Changes

No recorded changes to this operation across all 1 revision of this API.