Account

Live account balances (per-key quota)

The true per-key quota endpoint for the logged-in console/dashboard. Returns all four transaction pools with their denominators, the real trial countdown, and Stripe subscription state — reflecting reality on load and after each call (not the frozen login-fragment snapshot).

Auth: the account's own API key — send X-Acuris-Key: <key> (primary). Authorization: Bearer <key>, X-API-Key, or the legacy ?key= query param is also accepted.

Transaction costs (Stripe-plan transactions, per call): validate = 1, geocode = 1, reverse = 1. During a trial the pool decrements 1 regardless of endpoint weight.

Per-product daily free limits apply (check remaining via /validate-credits and /geocode-credits); anonymous access is rate-limited per IP.

get/account/balances

Request

  • Base URL: https://api.acuris-geo.com
  • URL: https://api.acuris-geo.com/account/balances
  • Auth: one of:
    • API key in header X-Acuris-Key
    • HTTP bearer
    • API key in header X-API-Key
    • API key in query parameter key

Response

Live balances, trial countdown, and subscription state for the caller's key.

key_acceptedboolean required
trial_expires_atstring nullable

UTC trial-window end (YYYY-MM-DD HH:MM:SS), or null.

trial_expiredboolean

True once the trial calendar window has lapsed.

days_leftinteger nullable

Whole days remaining in the trial window, or null if no/unparseable expiry.

Example response

{
  "key_accepted": true,
  "pools": {
    "validation": {
      "remaining": 972,
      "total": 1000,
      "used_pct": 3
    },
    "geocode": {
      "remaining": 972,
      "total": 1000,
      "used_pct": 3
    },
    "email": {
      "remaining": 972,
      "total": 1000,
      "used_pct": 3
    },
    "phone": {
      "remaining": 972,
      "total": 1000,
      "used_pct": 3
    }
  },
  "trial_expires_at": "2026-07-30 00:00:00",
  "days_left": 14,
  "subscription": {
    "plan": "growth",
    "status": "active",
    "quota_used": 1240,
    "quota_limit": 50000
  }
}

Changes

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