Account

Self-serve evaluation key (zero-friction onboarding)

Recommended way to start. Mints a low-cap, short-lived evaluation key in one step — no password, no email round-trip, no free-domain block. The key is returned directly in the response body.

The key seeds ~100 transactions in each pool (validation, geocode — separate pools) and expires after 7 days. These are trial-pool credits: the pool decrements 1 per call regardless of endpoint. (Under a paid Stripe plan the same endpoints instead cost weighted transactions — e.g. validate=1, geocode=1, reverse=1.)

Rate-limited to 1 issuance per email and 1 per IP in any 24-hour window (and 60 requests/hour per IP overall). For more headroom, use the full /register flow (28-day trial). Per-product daily free limits apply to anonymous use — check remaining via /validate-credits and /geocode-credits; anonymous access is also rate-limited per IP.

post/dev-key

Request

  • Base URL: https://api.acuris-geo.com
  • URL: https://api.acuris-geo.com/dev-key
  • 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

Request body

emailstring required

A valid email address to associate with the key. Free providers (Gmail etc.) are accepted.

accept_termsboolean

true = you agree to the Acuris Geo Terms of Service and the UK PAF Evaluation Terms. Starts the key's 90-day UK evaluation. When terms acceptance is enforced, a request without it returns 400 terms_acceptance_required; send it on every request.

countrystring nullable

Optional ISO country hint (e.g. gbr). Drives the returned info_url and, for gbr, adds a paf_note about UK (Royal Mail PAF) evaluation limits.

Example request

{
  "email": "you@example.com",
  "accept_terms": true,
  "country": "gbr"
}

Response

Evaluation key issued. Send it as X-Acuris-Key: <key> (or Authorization: Bearer, X-API-Key, or ?key=) on subsequent calls.

api_keystring required

The evaluation key. Send it as X-Acuris-Key: <key> (or Authorization: Bearer / X-API-Key / ?key=) on validation/geocoding calls.

validation_creditsinteger required

Address-validation pool seeded on the key.

geocode_creditsinteger required

Geocode pool seeded on the key.

phone_creditsinteger required

Offline phone-validation pool seeded on the key.

expires_atstring required

Expiry timestamp (UTC), 7 days from issuance.

tierstring required
info_urlstring required

Pricing / info page (UK-specific for a gbr country hint).

next_stepsstring required

Short onboarding note pointing to /register for more headroom.

paf_notestring nullable

Present only when the request country hint is gbr — notes that UK addresses (Royal Mail PAF) are evaluation-only under a dev key.

uk_evaluation_expires_atstring nullable

Present only when the request sent "accept_terms": true — end of the key's free UK evaluation (UTC).

Example response

{
  "api_key": "s3cr3t-eval-token",
  "validation_credits": 100,
  "geocode_credits": 100,
  "phone_credits": 100,
  "expires_at": "2026-07-23 12:00:00 UTC",
  "tier": "dev",
  "info_url": "https://acuris-geo.com/acuris-pricing/"
}

Changes

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