I define the data I need and the associated access method.

• The facility identification data and the information describing the healthcare services are sufficient for me
• The weekly update meets my needs

I download the public ROR data (mev2.4 CSD) in XML format from the data.gouv.fr platform. I do not need to proceed further in the process.

I’m integrating my application with the national ROR APIs.
The web services are available in both FHIR and CSD formats.

Important note: Web services in CSD format (meV2.4) are deprecated and do not support, among other things, bed/bed space availability. This format will be discontinued at the end of Q1 2026. We strongly recommend that you connect to the FHIR MEV3.0 APIs.

• Case 1: I retrieve the complete initialization of the national ROR via an $export query.
• Case 2: I retrieve service data via targeted FHIR queries (multiple search criteria, fewer than 10,000 results).
• Case 3: I retrieve capacity data on a very regular basis via a dedicated cache.
   

• Case 1: I need to initialize all the data:
  • I initialize my database using the ROR service via the "TR-Récupération Extraction" web service (REST service)
  • I update my database using the following web services:
    • TR-Notif-ListeEtablissementMajApresDate (SOAP service)
    • TR-Lecture-OffresSanteEtablissement (SOAP service)
• Case 2: I import the offer for a single facility that I have selected in my business tool using the TR-Lecture-OffresSanteEtablissement web service (SOAP service).
• Case 3: I import information for a specific part of the organization that I identify using its identifier (the internal organization identifier—division/department/…/basic unit assigned by the national ROR) using the TR-Lecture-OffresSanteOrganisationInterne web service (SOAP service)

Please review the documents below for a detailed overview of all transactions.