AccountCloud
ENMaak een testsleutel

Het juiste adresformulier voor 34 landen.

Welke velden een adres in een land heeft, in welke volgorde, welke verplicht zijn en hoe de postcode eruitziet. En een adres controleren en opmaken zoals het land het schrijft.

Maak een testsleutelLees de gids
Status
LiveAlgemeen beschikbaar, voor live- en testsleutels.
Prijs
gratis
Operaties
address.formsaddress.validateaddress.format
Docs
De gidsAPI-referentieTestwaardenDe docs zijn in het Engels.

Wat het doet

Wat je ermee kunt

  • Het formulier per land. De velden in de volgorde waarin je ze vraagt, met een label in het Nederlands of Engels, wat verplicht is, de maximale lengte, het autocomplete-token voor HTML en een plek op een raster van 12 kolommen. Daarbij het postcodepatroon met een voorbeeld, en de provincies of regio’s waar een land die gebruikt.
  • Een adres controleren. Je krijgt het adres genormaliseerd terug: getrimd, de postcode in de vorm van het land en een regio als code. Klopt er iets niet, dan zegt het antwoord per veld wat.
  • Een adres opmaken. De regels zoals het land van het adres ze schrijft. Komt de brief uit een ander land, dan komt de landregel erbij.

De landen

De EU, de EER, Zwitserland, het Verenigd Koninkrijk, Turkije en de Verenigde Arabische Emiraten: AE, AT, BE, BG, CH, CY, CZ, DE, DK, EE, ES, FI, FR, GB, GR, HR, HU, IE, IS, IT, LI, LT, LU, LV, MT, NL, NO, PL, PT, RO, SE, SI, SK en TR.

Waar het vandaan komt

Het register combineert de adresgegevens van Google libaddressinput met de regels van de nationale postbedrijven, en is per land getoetst met vaste voorbeelden. Het veld verified zegt of een formulier is nagelopen tegen de regels van het postbedrijf van dat land.

De adresformulieren zijn deels gebaseerd op de adresgegevens van Google libaddressinput, onder de licentie CC BY 4.0, met onze eigen aanpassingen per land.

Goed om te weten

  • De adresformulieren zijn live en gratis. Controleren en opmaken zijn in preview: zolang ze geen prijs hebben, krijgt een live-sleutel 503 operation_unavailable. Testsleutels geven al echte antwoorden.
  • Een land dat we niet kennen krijgt 404 country_not_supported, met de lijst van landen die we wel kennen.

Voorbeeld

Echte calls met een testsleutel. Vervang ac_test_… door je eigen sleutel.

Het adresformulier van Nederland: welke velden, in welke volgorde, en de postcode.
GET/v1/address/forms/NL
Request
curl https://api.accountcloud.io/v1/address/forms/NL \
  -H "Authorization: Bearer ac_test_…"
Response200 OKingekort
AccountCloud-Charged: 0.0000
{
  "country": "NL",
  "verified": true,
  "fields": [
    {
      "id": "street",
      "label": "Street",
      "type": "text",
      "required": true,
      "max_length": 255,
      "options": null,
      "options_source": null,
      "example": null,
      "autocomplete": "address-line1",
      "layout": { "row": 1, "column": 1, "span": 8 }
    },
    {
      "id": "postal_code",
      "label": "Postal code",
      "type": "text",
      "required": true,
      "max_length": 20,
      "options": null,
      "options_source": null,
      "example": "1234 AB",
      "autocomplete": "postal-code",
      "layout": { "row": 3, "column": 5, "span": 4 }
    }
  ],
  "postcode": {
    "pattern": "[1-9]\\d{3} ?(?:[A-RT-Z][A-Z]|S[BCE-RT-Z])",
    "example": "1234 AB"
  },
  "subdivisions": []
}
Een adres controleren: de postcode komt genormaliseerd terug.
POST/v1/address/validate
Request
curl https://api.accountcloud.io/v1/address/validate \
  -H "Authorization: Bearer ac_test_…" \
  -H "Content-Type: application/json" \
  -d '{
    "address": {
      "country": "NL", "street": "Hoofdstraat", "house_number": "12",
      "postal_code": "1234ab", "city": "Amsterdam"
    }
  }'
Response200 OK
AccountCloud-Charged: 0.0000
{
  "valid": true,
  "address": {
    "country": "NL",
    "street": "Hoofdstraat",
    "house_number": "12",
    "postal_code": "1234 AB",
    "city": "Amsterdam"
  },
  "errors": []
}
Hetzelfde adres opgemaakt voor een brief vanuit België: met de landregel erbij.
POST/v1/address/format
Request
curl https://api.accountcloud.io/v1/address/format \
  -H "Authorization: Bearer ac_test_…" \
  -H "Content-Type: application/json" \
  -d '{
    "address": {
      "country": "NL", "street": "Hoofdstraat", "house_number": "12",
      "postal_code": "1234ab", "city": "Amsterdam"
    },
    "from_country": "BE"
  }'
Response200 OK
AccountCloud-Charged: 0.0000
{
  "country": "NL",
  "lines": ["Hoofdstraat 12", "1234 AB Amsterdam", "Netherlands"],
  "text": "Hoofdstraat 12\n1234 AB Amsterdam\nNetherlands"
}

Wat het kost

Adressengratishet adresformulier per land
Adres controlerenpreviewprijs volgtvelden en postcode volgens het land
Adres opmakenpreviewprijs volgtals regels voor een envelop

Exclusief btw, van je tegoed. Testsleutels zijn gratis, en een fout of ongeldige invoer kost niets.

Zolang er geen prijs is, krijgt een live-sleutel 503 operation_unavailable. Testsleutels werken al.

Verder lezen

Begin met een testsleutel. Die is gratis.

Aanmelden kost een minuut. De quickstart in de docs vijf.

Maak een testsleutelLees de gids