I identify the data I need and the associated access mode

01. Learn more about the ROR

I identify the data I'm going to use

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

02. I choose the method for retrieving data from the national ROR healthcare offering

I download public data via files updated once a week

  • The data identifying the structures as well as the data describing the healthcare offer are enough for me
  • The weekly update meets my needs

I download the public data from the ROR (mev2.4 CSD) in xml format on the data.gouv.fr platform. I don't need to go any further in the course.

I would like to consume public and/or restricted healthcare data via webservices

I interface my application with the APIs of the national ROR.
Webservices are available in FHIR format as well as in CSD format.

Point of attention: Webservices in CSD format (meV2.4) are deprecated and do not allow, among other things, availability in beds/places. This format will be discontinued at the end of Q1 2026. We strongly recommend that you connect to the FHIR MEV3.0 APIs.

03. I identify the webservices I need

If I choose FHIR webservices based on MEV3.0, I select the webservices I need from the following 3 cases:

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

If I choose CSD webservices based on MEV2.4 (decommissioned end of Q1 2026), I choose the webservices I need from the following 3 cases:

  • Case 1: I need to initialize all data:
    • I initialize my database with the ROR offer with the "TR-Recovery Extraction" webservice (REST service)
    • I update my database with the following webservices:
      • TR-Notif-ListeEtablissementMajApresDate (SOAP service)
      • TR-Lecture-OffresSanteEtablissement (SOAP service)
  • Case 2: I import the offer of a single establishment I've selected in my business tool with the webservice TR-Lecture-OffresSanteEtablissement (SOAP service).
  • Case 3 : I import the information from a part of the organization that I identify from its identifier (the identifier of the internal organization (pole/department/.../elemental unit assigned by the national ROR) with the webserviceTR-Lecture-OffresSanteOrganisationInterne (SOAP service)

Need help?

Consult the documents below, for a detailed view of all transactions.

Download my complete ROR guided tour

Mon parcours guidé ROR