get_usage 0 credits

Check your balance, plan, limits, and the last 10 charges (receipt ids included). Costs 0 credits and is exempt from the per-minute rate limit, so call it whenever you need to budget. The response includes upgrade_url: give it to your human when credits or plan limits block you; purchases credit this account directly with no login. Trial accounts also get the claim_url for keeping the account. Not for creating an account (provision) or fetching LinkedIn data.

Parameters

No parameters.

REST

GET /v1/usage · auth: required · metered: false

curl "https://api.veezee.io/v1/usage" \
  -H "Authorization: Bearer $VEEZEE_API_KEY"

MCP

{
  "method": "tools/call",
  "params": {
    "name": "get_usage",
    "arguments": {}
  }
}

Input examples

Balance check

{}

Output

Returns a usage envelope. Full field list: /docs/fields#usage.

Errors

REST returns application/problem+json; MCP returns the same content as an error result. message is written as the next-turn instruction.

CodeHTTP statusRetriableMeaning
INVALID_INPUT400noA parameter failed validation. Check param and message for what to fix.
NOT_FOUND404noNothing matches the given identifier or URL.
UNAUTHORIZED401noMissing, invalid, or revoked API key.
PROVISION_REQUIRED401noNo key was sent and none is on file. Call provision first.
INSUFFICIENT_CREDITS402noYour balance can't cover this call's quote. Check get_usage or add credits.
QUOTE_EXCEEDS_MAX_CREDITS402noThe call's quote is higher than the max_credits you set. Nothing was charged.
IDEMPOTENCY_KEY_REQUIRED400noThis is a metered call; send an Idempotency-Key header.
IDEMPOTENCY_KEY_REUSED409noThat Idempotency-Key was already used with different arguments. Use a new key for a new call.
CONCURRENCY_LIMIT429yesToo many calls in flight for this key's plan. Wait for one to finish.
RATE_LIMITED429yesToo many calls per minute for this key's plan. Back off and retry.
TRIAL_CAP_EXCEEDED403noA trial-only limit was hit (concurrency, rate, search size, or realtime fetches).
BUDGET_EXHAUSTED503noA configured spend budget has been used up.
UPSTREAM_UNAVAILABLE502yesLinkedIn data wasn't reachable. Safe to retry.
PAYLOAD_TOO_LARGE413noThe request or response exceeded the size limit.
ORIGIN_FORBIDDEN403noThis request's origin isn't allowed to call the API.
INTERNAL500yesSomething failed on our side. Safe to retry.