3 - Administration

Vérifier des adresses postales

Permet de vérifier la validité des adresses postales grâce à notre IA.

En sandbox, le endpoint est disponible gratuitement dans la limite de 100 adresses vérifiées par mois.
En production, le endpoint est disponible pour les abonnements payants uniquement, dans la limite de 50 000 adresses vérifiées par jour.

Notre IA effectue une analyse en profondeur afin d’obtenir en réponse :

  • une mise en forme de l’adresse dans le strict respect des normes La Poste (pour être par exemple apposé sur les envois de Service Postal)
  • un pourcentage de fiabilité de l’adresse soumise, pour permettre à nos clients d’utiliser cette API pour éventuellement nettoyer ou à minima qualifier leur données d’adresses, avant de nous soumettre des demandes de courriers en nombre
  • une ou plusieurs suggestions de corrections le cas échéant (celles-ci incluent la détection de fautes de frappe, ou de noms de villes ou de rues mal orthographiées)
  • une géolocalisation de l’adresse, au format coordonnées Google Maps; cette information peut être intéressante, par exemple pour visualiser d’un coup d’oeil la dispersion géographique des destinataires, par exemple sur un envoi en nombre
post/iapostale

Request

  • Base URL: https://sandbox-api.servicepostal.com
  • URL: https://sandbox-api.servicepostal.com/iapostale
  • Auth: none declared

Response

Opération réussie

Example response

{
  "addresses": [
    {
      "error": false,
      "usable_as_is": true,
      "address_fields": {
        "civility": "M.",
        "firstname": "JACQUES",
        "lastname": "MARTIN",
        "address_line_1": "66 AV. DES CHAMPS ELYSEES",
        "address_line_2": "JM PRODUCTIONS",
        "number": "66",
        "zipcode": "75008",
        "city": "PARIS",
        "country": "FRANCE",
        "country_sp_id": 1,
        "coordinates": "48.872724688,2.312557715",
        "address_reliability_score": 100
      }
    },
    {
      "error": false,
      "usable_as_is": true,
      "address_fields": {
        "civility": "M.",
        "firstname": "LEON",
        "lastname": "ZITRONE",
        "address_line_1": "116 AVENUE DU PRESIDENT KENNEDY",
        "address_line_2": "ORTF",
        "number": "116",
        "zipcode": "75016",
        "city": "PARIS",
        "country": "FRANCE",
        "country_sp_id": 1,
        "coordinates": "48.860373457,2.261967959",
        "address_reliability_score": 100
      }
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.