Geocoding

Geocode free tier or key balance

Without a key: returns free_remaining anonymous geocodes for this IP. With a valid key (header or ?key=): the keyed response also returns balance, validation_credits, geocode_credits, credits, and trial_expired; free_remaining is null.

get/geocode-credits

Request

  • Base URL: https://api.acuris-geo.com
  • URL: https://api.acuris-geo.com/geocode-credits
  • 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
    • none

Query parameters

keystring

Legacy API key query parameter (?key=...). Prefer Authorization: Bearer <key> or X-API-Key: <key> header auth instead.

Response

Remaining anonymous free transactions and (when an API key is provided) the registered key's geocode transaction balance.

free_remaininginteger nullable
balanceinteger

Present when valid key supplied. Equals geocode_credits.

validation_creditsinteger

Present when valid key supplied.

geocode_creditsinteger

Present when valid key supplied.

creditsinteger

Combined transaction total; present when valid key supplied.

trial_expiredboolean

True when the key's trial window has lapsed (all balances read 0); present when valid key supplied.

Example response

{
  "free_remaining": 10
}

Changes

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