Migration guide

Move off DAWA
step by step

From dawa.aws.dk / api.dataforsyningen.dk to a drop-in alternative — without rewriting your code.

1. Get an API key

Create a free account at danadresse.dk/signup (no credit card, 1,000 calls/month). Copy your key — it looks like dawa_live_…. Use a dawa_test_ key for development.

2. Change the base URL

Find every place your code calls DAWA and replace the host. The rest of the URL (path + query) stays the same.

- https://dawa.aws.dk/autocomplete?q=rådhus
- https://api.dataforsyningen.dk/adresser?postnr=8000
+ https://api.danadresse.dk/autocomplete?q=rådhus
+ https://api.danadresse.dk/adresser?postnr=8000

3. Add your key

Send the key as an X-Api-Key header (recommended) or as a ?api_key= query param (for browser/JSONP). Without a key you get the free per-IP tier.

curl 'https://api.danadresse.dk/autocomplete?q=rådhuspladsen' \
     -H 'X-Api-Key: dawa_live_…'

4. Verify the response matches

The response has the same fields and the same address IDs (DAR UUID) as DAWA. Run your existing tests against the new base URL — they should pass unchanged.

5. Error handling & rate limits

  • 429 Too Many Requests means rate-limited. Headers X-RateLimit-Remaining and X-RateLimit-Limit show status.
  • Errors follow the same JSON convention. Implement retry with backoff on 429/5xx.
  • Free tier: 1,000 calls/month. Upgrade to Basic/Pro for more.

6. Test in parallel, roll out safely

Run both base URLs side by side behind a feature flag. Compare responses on samples. When confident, flip the flag for everyone. Rollback = flip it back.

Get a free key Code examples →

Using a specific tool?

We have ready recipes for WordPress/WooCommerce, frameworks and no-code.

See integrations →