Get started · ~5 minutes
From zero to your first resolved address.
Authenticate, set your defaults, choose a scope, and read the result — one engine, two API groups.
acme trading ltdLONDON??u.k.
<Nm> Acme Trading Ltd<TwnNm> London<Ctry> GB
✓ VALIDATED · 100% accurate · 43 ms · rule_source EPC153-22 §4
Four steps to live01 — 04Each call inherits your channel defaults.
1Get credentialsTwo factors per call — an OAuth bearer token and an X-API-Key. Test keys for sandbox, live keys for production.
2Set up a channelRegister scheme, direction, output mode and thresholds once; every later call reuses them via channelName.
3Pick your scopeFixing stored data? Call the Party Address API. Fixing a payment message? Call the Message Address API.
4Read the statusVALIDATED / REPAIRED / PARTIALLY_REPAIRED / NOT_REPAIRED, with structured reason codes on every miss.
Your first callStructurally check one address.
# Your first call - structurally check one address
curl -X POST https://sandbox.ionova.io/ars/v4/check-party-address \
-H "Authorization: Bearer $TOKEN" -H "X-API-Key: $ARS_KEY" \
-H "Content-Type: application/json" \
-d '{"postalAddress":{"country":"DE","townName":"Berlin"}}'