API ORIAS - Développeurs

Documentation API ORIAS

Guide complet pour intégrer le service SOAP officiel de l'ORIAS dans vos applications.

API ORIASSOAPws.orias.frDocumentation 2025

Introduction à l'API ORIAS

L'ORIAS (Organisme pour le Registre unique des Intermédiaires en Assurance, Banque et Finance) met à disposition un service web SOAP permettant de vérifier l'inscription des intermédiaires au registre officiel. Ce service est accessible via l'URL https://ws.orias.fr/service?wsdl.

Ce service SOAP permet de vérifier en temps réel le statut d'inscription d'un intermédiaire, que ce soit par son numéro ORIAS à 8 chiffres ou son numéro SIREN à 9 chiffres.

Caractéristiques principales de l'API ORIAS :

  • Interface SOAP avec description WSDL complète
  • Authentification par clé privée
  • Requêtes et réponses au format XML
  • Données en temps réel provenant du registre officiel
  • Support de recherche par numéro ORIAS ou SIREN

Architecture du Service SOAP

Le service SOAP de l'ORIAS est structuré selon les standards W3C et fonctionne comme suit :

  1. Votre application construit une enveloppe SOAP contenant la requête
  2. La requête inclut la clé d'authentification et les critères de recherche
  3. Le serveur ORIAS traite la requête et interroge le registre
  4. Le serveur renvoie une réponse SOAP contenant les résultats
  5. Votre application doit parser cette réponse XML pour en extraire les informations

Note importante : L'accès au service SOAP de l'ORIAS nécessite une clé d'authentification qui doit être obtenue auprès de l'ORIAS. L'utilisation de cette API est soumise aux conditions d'utilisation de l'ORIAS.

Structure de la Réponse XML

Les réponses du service SOAP ORIAS suivent une structure XML standardisée :

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <ns2:intermediarySearchResponse xmlns:ns2="urn:gpsa:orias:ws.001">
      <intermediaries>
        <intermediary>
          <informationBase>
            <foundInRegistry>true|false</foundInRegistry>
            <registrationNumber>12345678</registrationNumber>
            <denomination>NOM DE LA SOCIÉTÉ</denomination>
            <siren>123456789</siren>
          </informationBase>
          <registrations>
            <registration>
              <category>COA|AGA|MA|MIA|MIOBSP|etc.</category>
              <registrationDate>YYYY-MM-DD</registrationDate>
              <status>INSCRIT|SUPPRIME</status>
              <collectFunds>true|false</collectFunds>
              <deletionDate>YYYY-MM-DD</deletionDate> <!-- présent seulement si statut=SUPPRIME -->
            </registration>
            <!-- Possibilité d'avoir plusieurs inscriptions/catégories -->
          </registrations>
        </intermediary>
      </intermediaries>
    </ns2:intermediarySearchResponse>
  </soap:Body>
</soap:Envelope>

Explication des principaux champs :

  • foundInRegistry : Indique si l'intermédiaire est trouvé dans le registre
  • registrationNumber : Numéro d'inscription ORIAS à 8 chiffres
  • denomination : Dénomination sociale de l'intermédiaire
  • siren : Numéro SIREN à 9 chiffres
  • category : Type d'inscription (COA = Courtier en assurance, etc.)
  • status : Statut d'inscription (INSCRIT ou SUPPRIME)
  • collectFunds : Autorisation d'encaissement de fonds

Besoin d'Aide pour l'Intégration de l'API ORIAS ?

Cette documentation vise à vous aider à comprendre et intégrer le service SOAP officiel de l'ORIAS. Pour toute question technique ou accès à l'API, contactez directement l'ORIAS ou utilisez notre service simplifié.