API credits balance check

Return the remaining prepaid credit, in USD, of the rk_ key sent as Authorization: Bearer. Free and not counted against the free tier; without a valid key it returns invalid_key.

freeGET /v1/balanceMCP balanceFree, needs a key

What you get

  • The remaining credit of your rk_ key, in USD
  • The same answer over HTTP (GET /v1/balance) and MCP (tool balance)

Parameters

    Try it

    With a key, every Run is paid from your credits and the balance updates after each call. Kept only in this browser tab; sent only to this site.

    Free: reads the balance of the API key above; does not count against the free tier.

    Equivalent curl
    curl -H "Authorization: Bearer rk_YOUR_KEY" "https://402check.com/v1/balance"

    Example response

    Example response
    {
  "balanceUsd": 4.99
}

    A $5 key after one ro_company call, from our tests.

    HTTP

    Request
    curl -H "Authorization: Bearer rk_YOUR_KEY" "https://402check.com/v1/balance"

    MCP

    tools/call request
    {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "balance",
    "arguments": {}
  }
}

    Endpoint https://402check.com/mcp. Setup for Cursor, Claude and other clients is in the docs.

    Source and limits

    Data from 402check key store.

    • Needs a credits key sent as Authorization: Bearer rk_…; without one it answers 401 invalid_key
    • Free and not counted against the free tier

    Questions

    How much does a balance check cost?

    Nothing. It is free and does not count against the free tier.

    Why do I get invalid_key?

    The request had no Authorization: Bearer rk_… header, or the key is unknown.

    How do I add credit?

    Buy another package at /buy; it comes as a new key with its own balance.