Usage

Get usage and balance

The prepaid balance (ledger, pending mention charges, and the effective balance the stop rule reads), the daily burn and the days it buys, the keywords the wallet runs and pauses, the matches recorded today and over 30 days, and whether tracking is stopped or the balance is low. Every matched mention bills ($0.008), relevant or not; every active keyword bills $5 a month, charged daily.

GET
/v1/usage
AuthorizationBearer <token>

API key minted via POST /v1/api-keys (format mk_live_...)

In: header

Response Body

application/json

application/json

curl -X GET "https://api.mentio.dev/v1/usage"
{
  "balance": {
    "cents": 0,
    "pendingCents": 0,
    "effectiveCents": 0,
    "currency": "USD"
  },
  "burn": {
    "perDayCents": 0,
    "daysLeft": 0
  },
  "keywords": {
    "active": 0,
    "paused": 0,
    "limit": 0,
    "dayCents": 0
  },
  "mentions": {
    "today": 0,
    "last30d": 0
  },
  "stopped": true,
  "lowBalance": true,
  "lastTopUpAt": "string"
}
{
  "error": {
    "code": "unauthorized",
    "message": "string",
    "requestId": "string",
    "retryAfterSeconds": 0
  }
}