Validate and normalize address API

Validate address against national address registries across 8 EU countries.

POST /v1/check/address1× multiplier

Quick Start

Make your first API request in 3 steps:

1Make API Request

curl -X POST https://api.scorika.com/v1/check/address \
  -H "X-Api-Key: sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"address":"Václavské náměstí 1, Praha","country":"CZ"}'

import requests

response = requests.post(
    "https://api.scorika.com/v1/check/address",
    headers={"X-Api-Key": "sk_live_your_api_key"},
    json={"address"=>"Václavské náměstí 1, Praha", "country"=>"CZ"}
)
print(response.json())

const res = await fetch('https://api.scorika.com/v1/check/address', {
  method: 'POST',
  headers: {'X-Api-Key': 'sk_live_your_api_key', 'Content-Type': 'application/json'},
  body: JSON.stringify({"address":"Václavské náměstí 1, Praha","country":"CZ"})
});
console.log(await res.json());

require 'net/http'
require 'json'

uri = URI('https://api.scorika.com/v1/check/address')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
req = Net::HTTP::Post.new(uri)
req['X-Api-Key'] = 'sk_live_your_api_key'
req['Content-Type'] = 'application/json'
req.body = {"address":"Václavské náměstí 1, Praha","country":"CZ"}.to_json
puts http.request(req).body

2Handle Response

Vastaus

{
  "data": {
    "address": "Václavské náměstí 1, Praha",
    "country": "CZ",
    "found": true,
    "score_delta": 0,
    "reason_codes": [],
    "enrichment": {
      "normalized_address": "Václavské náměstí 1, Praha, 110 00",
      "address_id": "12345678",
      "street": "Václavské náměstí",
      "city": "Praha",
      "postal_code": "110 00",
      "gps": {
        "latitude": 50.0806,
        "longitude": 14.4286,
        "coordinate_system": "EPSG: 5514"
      },
      "address_type": "standard",
      "match_quality": 0.95,
      "source": "ruian"
    }
  },
  "meta": {
    "request_id": "req_address123",
    "api_version": "2024-01-20",
    "cached": false,
    "cache_ttl": 86400,
    "latency_ms": 180
  }
}

3Try It Now

Interactive API Explorer

Try the API directly from your browser. No API key required for testing.

Request Body

Response

Waiting for response...

Ready for production?

Get your API key to use this endpoint in your application.

Get API Key →

Response Schema

{
  "$ref": "#/components/schemas/AddressCheckResponse"
}

Hinnoittelu

Pricing Calculator

This endpoint uses a 1× multiplier on your base plan rate.

Pro Plan

$0.001/base check

1× = $0.001 per request

$1.0/mo

Pricing Calculator

This endpoint uses a 1× multiplier on your base plan rate.

Pro Plan

$0.001/base check

1× = $0.001 per request

$1.0/mo

Enterprise

$0.001/base check

1× = $0.001 per request

$10.0/mo

Pricing Calculator

This endpoint uses a 1× multiplier on your base plan rate.

Pro Plan

$0.001/base check

1× = $0.001 per request

$1.0/mo

Pricing Calculator

This endpoint uses a 1× multiplier on your base plan rate.

Pro Plan

$0.001/base check

1× = $0.001 per request

$1.0/mo

Enterprise

$0.001/base check

1× = $0.001 per request

$10.0/mo

Batch (20% off)

$0.0008/base check

1× = $0.0008 per request

$40.0/mo

Pricing Calculator

This endpoint uses a 1× multiplier on your base plan rate.

Pro Plan

$0.001/base check

1× = $0.001 per request

$1.0/mo

Pricing Calculator

This endpoint uses a 1× multiplier on your base plan rate.

Pro Plan

$0.001/base check

1× = $0.001 per request

$1.0/mo

Enterprise

$0.001/base check

1× = $0.001 per request

$10.0/mo

Pricing Calculator

This endpoint uses a 1× multiplier on your base plan rate.

Pro Plan

$0.001/base check

1× = $0.001 per request

$1.0/mo

Pricing Calculator

This endpoint uses a 1× multiplier on your base plan rate.

Pro Plan

$0.001/base check

1× = $0.001 per request

$1.0/mo

Enterprise

$0.001/base check

1× = $0.001 per request

$10.0/mo

Batch (20% off)

$0.0008/base check

1× = $0.0008 per request

$40.0/mo

💡 Tip: Bulk requests get a 20% discount. Contact sales for custom pricing on high-volume usage.

Common Use Cases

Address Verification

Normalize and validate shipping addresses

KYC Compliance

Verify customer addresses for regulatory requirements

Related Endpoints

Company Verification

Verify company registration

IBAN Validation

Validate bank account details

Start Using Validate and normalize address API

Get your API key in 30 seconds. No credit card required.

Get API Key →