---
title: "Quickstart"
url: "https://dev.ionova.ai/get-started"
image: "https://dev.ionova.ai/_og/d/c_Ocean.takumi,title_Quickstart,props_eyJ0aGVtZSI6eyJtb2RlIjoibGlnaHQiLCJjb2xvcnMiOnsicHJpbWFyeSI6IiMyRTUwOTAifX19,p_Ii9nZXQtc3RhcnRlZCI,s_0nOT7813uN1v3iJH.png"
---

Quickstart · ~5 minutes

# From zero to your first _resolved_ address.

Authenticate, register a channel, call one endpoint, read the verdict — one deterministic engine, two API groups, sub-50ms.

[Get sandbox keys](https://dev.ionova.ai/authentication)[Core concepts](https://dev.ionova.ai/concepts)

ARS · AutoCorrect✓ repaired

acme trading ltdLONDON??u.k.

<Nm> Acme Trading Ltd<TwnNm> London<Ctry> GB

✓ REPAIRED · sub-50ms · rule\_source EPC153-22 §4

Four steps to _live_01 — 04Every call inherits your channel defaults.

1Get credentialsTwo factors per call — an OAuth bearer token and an `X-API-Key`. Register an app for test keys (sandbox) and live keys (production).

2Register a channelSet scheme, direction, output mode and thresholds once; every later call reuses them via `channelName`.

3Pick your scopeFixing a stored address? Call the Party Address API. Fixing a payment message? Call the Message Address API. Same verbs, two scopes.

4Read the status`COMPLIANT` / `NOT_COMPLIANT` on a check; `VALIDATED` / `REPAIRED` / `PARTIALLY_REPAIRED` / `NOT_REPAIRED` on a convert — with a reason code on every miss.

Your _first_ callStructurally check one address — no postal DB, sub-100ms.

bash · check-party-address

```bash
# 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"}}'
```

**Why it matters —** from **15 November 2026** both SWIFT CBPR+ (SR2026) and EPC SEPA begin _rejecting_ — not flagging — any payment whose address lacks a structured town and country. ARS returns a corrected, transmit-ready address in a single call, every fix citing a regulatory `rule_source`.

Where next

[Core concepts](https://dev.ionova.ai/concepts)[Channels](https://dev.ionova.ai/channels)[Find your path](https://dev.ionova.ai/solutions)[API reference](https://dev.ionova.ai/apis)