PRIM's 2024 back-to-school season is marked by the arrival of two new features. From now on, remember to fill in your&nbsp;<a href="http://prim.iledefrance-mobilites.fr/fr/organisations" rel="noreferrer">Organization</a> and share your&nbsp;<a href="http://prim.iledefrance-mobilites.fr/fr/reutilisations" rel="noreferrer">Reuses</a>!

Discover PRIM's new features!

&nbsp;The datasets service aims to share and open up transport data from Île-de-France Mobilités to the&nbsp; general public. It brings together a set of datasets, network maps and other information around the&nbsp; transport data.The datasets service&nbsp;in a few figures:&nbsp;<ul><li>More than 75 datasets published</li><li>More than 60 datasets produced by Ile-de France mobilités</li><li>More than 3 million downloads per month</li></ul><h2 id=""></h2><a href="http://prim.iledefrance-mobilites.fr/catalogue-data?type=jeu_de_donnees" rel="noreferrer">Discover the Datasets available on PRIM</a>

Explore a dataset

An organization is a local authority, a transport operator, a company, or any body that produces or reuses data from the PRIM catalog ( datasets, APIs or widgets) in open format.<h3 id="la-d%C3%A9 déclaration-des-organisations-un-partenariat-gagnant-gagnant%E2%80%8B">La déclaration des organisations, un partenariat gagnant-gagnant!</h3>For you : Highlighting your organization as a data reuser gives visibility to your organization and the work being done; while inspiring other organizations or reusers. For IDFM: Highlighting data reuser organizations reinforces PRIM's image as the reference platform for mobility data in Île-de-France. PRIM users can thus declare their organization so that it is visible on PRIM: a user can declare a single organization.

What is an organization?

<h3 id="acc%C3%A9der-aux-organisations%E2%80%8B">Accessing organizations</h3>Consulting and sharing organizations is accessible in two places on the PRIM site: <ol><li>From the "&nbsp;Organizations&nbsp;" accessible via the "&nbsp;Data&nbsp;" menu of the PRIM platform. </li><li>From the "&nbsp;Contribute&nbsp;" page of the PRIM platform.</li></ol><h3 id="d%C3%A9clarer-une-organisation%E2%80%8B">Declarer une organisation</h3>To declare the organization to which you belong, simply click on the button "&nbsp;Complete the form&nbsp;" button on the "&nbsp;Organizations&nbsp;" page, or click on the "&nbsp;Declare your organization&nbsp;" button on the "&nbsp;Contribute&nbsp;" page. You'll then need to log in to your PRIM account, if you haven't already done so, and complete the organization declaration form. Once the form has been completed and submitted, it will be processed by our teams, who will be able to proceed with its validation. Processing time is approximately two weeks. When your organization declaration request is validated, you receive an email and the organization is automatically published and highlighted on PRIM.<h3 id="refusal-d%E2%80%99an-application-for-declaration-d%C3%A9%E2%80%99organization">Refusal of an organization declaration request</h3>It may happen that an organization declaration request is refused. When your organization declaration request is refused, you will receive an email in which the reason for refusal is systematically indicated and the organization will not appear on PRIM.

Register an organization

<h3 id="modification-d%E2%80%99an-organization">Modification of an organization</h3>For one reason or another, the content of an organization declaration, may be modified by our teams before or after its publication on PRIM. The elements that may be modified are, for example, the organization's site or description. Depending on the degree of importance of the modification made, you will be notified or not, by e-mail of the modification made to your organization declaration.However, it is not possible to modify certain information such as: the email or type of organization already published or awaiting validation. You will need to submit a new organization declaration request if you want changes to be made to these elements.<h3 id="deletion-d%E2%80%99an-organization-%E2%80%8B">Deleting an organization </h3>Following a request from you, or for one reason or another, an organization already published on PRIM, can be deleted by our teams. When your organization is deleted, you will receive an e-mail in which the reason for deletion is systematically indicated and the organization is no longer featured on PRIM.

Modifying and deleting an organization

The organizations

The dataset authentication system allows all users to have just one authentication token to insert in order to automate the download of datasets subject to the Mobility License.&nbsp;&nbsp;The datasets subject to this license are identifiable via the words "&nbsp;Connection Required&nbsp;" :&nbsp;The authentication system for restricted-access datasets on "&nbsp;PRIM&nbsp;"1) Access to the "My authentication tokens" page,which will allow you to generate this authentication token, will be done directly from your personal menu, once logged in2) Once on the "My authentication tokens"select the"DATASETS" taband click&nbsp; "Generate token"&nbsp;3) Once generated, you will be able to see the token in its entirety and copy it to your clipboard(the entire token has been hidden in the example above)The&nbsp;previously generated token will still be visible&nbsp;and will not be&nbsp;hidden when the page reloads.&nbsp;You can also regenerate your token: simply click on "&nbsp;generate my new token"then on"&nbsp;confirm&nbsp;".&nbsp;Attention&nbsp;: this token will render the previous token obsolete.&nbsp;4) Once your token has been generated on the PRIM site, simply select "API Key" as the authentication type, then fill in :&nbsp;<ul><li>"Authorization" in the "Key"&nbsp;</li><li>"apikey" + the value of your key (both must be separated by a space as shown in the capture) in the "Value"&nbsp;</li></ul><figure class="kg-card kg-image-card kg-card-hascaption"><img src="http://prim.iledefrance-mobilites.fr/content/images/2024/10/jdd-lien.png" class="kg-image" alt="" loading="lazy" width="1394" height="525" srcset="http://prim.iledefrance-mobilites.fr/content/images/size/w600/2024/10/jdd-lien.png 600w, http://prim.iledefrance-mobilites.FR/content/images/size/w1000/2024/10/jdd-lien.png 1000w, http://prim.iledefrance-mobilites.fr/content/images/2024/10/jdd-lien.png 1394w" sizes="(min-width: 720px) 720px"><figcaption>Example on Postman application</figcaption></figure>

Generate a token to access restricted datasets

Datasets

The API service aims to share dynamic transport data with the general public. The API service brings together a set of theoretical and real-time dataon the themes of next departure times, route and location searches, disruptions, isochrone calculations, exploration of the Ile-de France transport network.The API service in figures:<ul><li>More than 8 APIs published</li><li>More than 6 APIs produced by Ile-de France mobilités</li>More than 170 million requests per month</li></ul><a href="http://prim.iledefrance-mobilites.fr/en/catalogue-data?type=api" rel="noreferrer">Discover the APIs available on PRIM</a>

Explore APIs

<ul><li>Call quotas are by the day and by the second: it is strongly recommended to smooth out the number of requests over time so as not to disrupt operation for other users.</li><li>Given the very large size of the response to the global request "&nbsp;Next Departures&nbsp;" It is recommended that you activate the "&nbsp;Accept-encoding : gzip, deflate&nbsp;" element in the headers of your requests, to optimize API response times.</li></ul> We recommend that you activate the "&nbsp;Accept-encoding : gzip, deflate&nbsp;" element in the headers of your requests, to optimize API response times.

Best practices for using APIs

The page "&nbsp;Our offer&nbsp;"On PRIM, in the "Data&nbsp;" section,&nbsp; there's a page "&nbsp;Our offer&nbsp;"which provides Île-de-France Mobilités' offer dedicated to the APIs available in the catalog. On this page, you can find the monthly and/or daily request quotas for each API in the catalog. For information, no fees are charged by Île-de-France Mobilités to users of the APIs on the PRIM platform.<figure class="kg-card kg-image-card kg-card-hascaption"><img src="http://prim.iledefrance-mobilites.fr/content/images/2024/10/NOTRE-OFFRE.png" class="kg-image" alt="" loading="lazy" width="814" height="679" srcset="http://prim.iledefrance-mobilites.fr/content/images/size/w600/2024/10/NOTRE-OFFRE.png 600w, http://prim.iledefrance-mobilites.fr/content/images/2024/10/NOTRE-OFFRE.png 814w" sizes="(min-width: 720px) 720px"><figcaption>Page extract <a href="http://prim.iledefrance-mobilites.fr/en/our-offer" rel="noreferrer">Our offer</a></figcaption></figure>The "&nbsp;API Status&nbsp;"Also in the "Data&nbsp;" section of PRIM, the "&nbsp;API Status&nbsp;"displays the availability at time T and also over the last 30 days of the APIs. The indicators (in percentages) presented on this page, allow to know the state of the services of the APIs concerned but do not evaluate the quality of the data broadcast.The "API Status" page also contains an "Agenda" section to inform users of upcoming scheduled service interruptions linked to production releases, bug fixes etc... <figure class="kg-card kg-image-card kg-card-hascaption"><img src="http://prim.iledefrance-mobilites.fr/content/images/2024/10/APICapture.png" class="kg-image" alt="" loading="lazy" width="710" height="422" srcset="http://prim.iledefrance-mobilites.fr/content/images/size/w600/2024/10/APICapture.png 600w, http://prim.iledefrance-mobilites.fr/content/images/2024/10/APICapture.png 710w"><figcaption>Extract from page <a href="http://prim.iledefrance-mobilites.fr/en/etat-des-api" rel="noreferrer">API status</a></figcaption></figure>The "&nbsp;My API consumption"Once logged into PRIM, the "&nbsp;My API consumption&nbsp;" page becomes available from its space. Two distinct services are accessible from this page: "&nbsp;My tracking&nbsp;" and "&nbsp;My alerts&nbsp;". The first allows you to visually monitor your API consumption. Quotas are separated into APIs with daily quotas and APIs with monthly quotas. The second service, "&nbsp;Mes alertes&nbsp;", enables you to receive an alert e-mail whenever a certain quota usage threshold has been crossed, in order to anticipate any quota overruns.<figure class="kg-card kg-image-card kg-card-hascaption"><img src="http://prim.iledefrance-mobilites.fr/content/images/2024/10/quotas.png" class="kg-image" alt="" loading="lazy" width="859" height="734" srcset="http://prim.iledefrance-mobilites.fr/content/images/size/w600/2024/10/quotas.png 600w, http://prim.iledefrance-mobilites.fr/content/images/2024/10/quotas.png 859w" sizes="(min-width: 720px) 720px"><figcaption>Excerpt from page <a href="http://prim.iledefrance-mobilites.fr/fr/ma-consommation-api" rel="noreferrer">My API consumption</a></figcaption></figure>From this page, you can increase your API quotas if your consumption requires it.

PRIM services associated with APIs

The authentication system for dynamic data allows all API or widget users to have just one and only one authentication token to insert in their API requests.<ul><li>Access to the "My authentication tokens" page, which will allow you to generate this authentication token, will be made directly from your personal menu, once logged in.</li><li>On the"My authentication tokens" page, within the"API" tab a "&nbsp;Generate my token" button will allow you to generate this token.&nbsp;</li><li>Once generated, you'll be able to see the token in its entirety (the whole token has been hidden in the example opposite)</li><li>The previously generated token will only be visible once in its entirety: you therefore have the option of copying in order to paste it in a&nbsp;safe place.</li><li>After generating your first jeton, you have the option of viewing only part of it (first 4 and last 4 characters) by refreshing or returning to the page.</li><li>You can regenerate your API token if you've lost the first token: simply click"&nbsp;Generate a new API token&nbsp;".&nbsp;</li></ul>Warning: this token will render the previous token obsolete and will only be visible in its entirety once&nbsp;Once your token has been generated on the PRIM site, simply add the "&nbsp;API Key&nbsp;" in the header of your request and fill in the generated key in the"&nbsp;Value&nbsp;"&nbsp;<figure class="kg-card kg-image-card kg-card-hascaption"><img src="http://prim.iledefrance-mobilites.fr/content/images/2024/10/CAPTUREAPI.png" class="kg-image" alt="" loading="lazy" width="1365" height="506" srcset="http://prim.iledefrance-mobilites.fr/content/images/size/w600/2024/10/CAPTUREAPI.png 600w, http://prim.iledefrance-mobilites.FR/content/images/size/w1000/2024/10/CAPTUREAPI.png 1000w, http://prim.iledefrance-mobilites.fr/content/images/2024/10/CAPTUREAPI.png 1365w" sizes="(min-width: 720px) 720px"><figcaption>Example on Postman application</figcaption></figure>

Generate a token to access the APIs

APIs

The Widget service aims to make services available to the general public in the form of interactive applications or websites. Reusers of widgets available on PRIM can thus enable their consumers or direct clientele to benefit from PRIM services as part of their business.There is currently one widget available on PRIM which is:the white label Itinerary search

Discover the widget service on PRIM

The "Itinerary search" white label from Île-de-France Mobilités enables you to easily integrate this widget into your website, giving your users the benefit of a multimodal route planner for their journeys. The "<a href="http://pprod.prim.iledefrance-mobilites.fr/fr/widgets/idfm-marque_blanche-a?tab=integration&ref=prim.iledefrance-mobilites.fr">Integration</a>" White label page will help you understand how to integrate the "Itinerary search" white label into your website.Use of the "Itinerary search" White label is conditional on holding a user account on the <a href="https://pprod.connect.iledefrance-mobilites.fr/auth/realms/connect-b2b/protocol/openid-connect/auth?client_id=prim&redirect_uri=https%3A%2F%2Fpprod.prim.iledefrance-mobilites.fr%2Ffr%2Faide-et-contact%2Fdocumentation%2Fdonnees-disponibles%2Fapi%2Fgenerer-un-jeton-pour-acceder-aux-api&response_type=code&scope=openid+email&ref=prim.iledefrance-mobilites.fr">PRIM</a>&nbsp;and the <a href="http://pprod.prim.iledefrance-mobilites.fr/fr/mes-jetons-authentification?ref=prim.iledefrance-mobilites.fr">generation of an API token</a> . To generate an API token on PRIM we invite you to consult above&nbsp;the "<a href="http://pprod.prim.iledefrance-mobilites.fr/fr/aide-et-contact/documentation/donnees-disponibles-2/explorer-les-api/generer-un-jeton-pour-acceder-aux-api?ref=prim.iledefrance-mobilites.fr" rel="noreferrer">Generate a token to access APIs</a>".Example of integration&nbsp;of Île-de-France Mobilités' "Itinerary search" white label on a website:<figure class="kg-card kg-image-card kg-card-hascaption"><img src="http://prim.iledefrance-mobilites.fr/content/images/2024/10/image-3.png" class="kg-image" alt="" loading="lazy" width="605" height="362" srcset="http://prim.iledefrance-mobilites.fr/content/images/size/w600/2024/10/image-3.png 600w, http://prim.iledefrance-mobilites.fr/content/images/2024/10/image-3.png 605w"><figcaption>Website image <a href="https://www.sortiraparis.com/?ref=prim.iledefrance-mobilites.fr" rel="noreferrer">Sortir à paris</a></figcaption></figure>

Getting started with White label Itinerary search

Widgets

Available data

The Plateforme d'échanges Île-de-France Mobilités collects the information, distributes itto other carriers, makes it availableto all.The services The Next Departures APIs offer data concerning:<ul><li><a href="http://prim.iledefrance-mobilites.fr/apis/idfm-ivtr-requete_globale" rel="noreferrer">Les</a><a href="http://prim.iledefrance-mobilites.fr/apis/idfm-ivtr-requete_globale" rel="noreferrer"> </a><a href="http://prim.iledefrance-mobilites.fr/apis/idfm-ivtr-requete_globale" rel="noreferrer">prochains</a><a href="http://prim.iledefrance-mobilites.fr/apis/idfm-ivtr-requete_globale" rel="noreferrer"> </a><a href="http://prim.iledefrance-mobilites.fr/apis/idfm-ivtr-requete_globale" rel="noreferrer">passages</a><a href="http://prim.iledefrance-mobilites.fr/apis/idfm-ivtr-requete_globale" rel="noreferrer"> </a><a href="http://prim.iledefrance-mobilites.fr/apis/idfm-ivtr-requete_globale" rel="noreferrer">for</a><a href="http://prim.iledefrance-mobilites.fr/apis/idfm-ivtr-requete_globale" rel="noreferrer"> </a><a href="http://prim.iledefrance-mobilites.fr/apis/idfm-ivtr-requete_globale" rel="noreferrer">all</a><a href="http://prim.iledefrance-mobilites.fr/apis/idfm-ivtr-requete_globale" rel="noreferrer"> </a><a href="http://prim.iledefrance-mobilites.fr/apis/idfm-ivtr-requete_globale" rel="noreferrer">les</a><a href="http://prim.iledefrance-mobilites.fr/apis/idfm-ivtr-requete_globale" rel="noreferrer"> </a><a href="http://prim.iledefrance-mobilites.fr/apis/idfm-ivtr-requete_globale" rel="noreferrer">Lines</a><a href="http://prim.iledefrance-mobilites.fr/apis/idfm-ivtr-requete_globale" rel="noreferrer"> </a><a href="http://prim.iledefrance-mobilites.fr/apis/idfm-ivtr-requete_globale" rel="noreferrer">disponibles</a><a href="http://prim.iledefrance-mobilites.fr/apis/idfm-ivtr-requete_globale" rel="noreferrer"> </a><a href="http://prim.iledefrance-mobilites.fr/apis/idfm-ivtr-requete_globale" rel="noreferrer">on</a><a href="http://prim.iledefrance-mobilites.fr/apis/idfm-ivtr-requete_globale" rel="noreferrer"> the</a><a href="http://prim.iledefrance-mobilites.fr/apis/idfm-ivtr-requete_globale" rel="noreferrer"> </a><a href="http://rec.prim.iledefrance-mobilites.fr/apis/idfm-ivtr-requete_globale?ref=prim.iledefrance-mobilites.fr" rel="noreferrer">réseau</a></li><li><a href="http://prim.iledefrance-mobilites.fr/apis/idfm-ivtr-requete_unitaire" rel="noreferrer">The</a><a href="http://prim.iledefrance-mobilites.fr/apis/idfm-ivtr-requete_unitaire" rel="noreferrer"> </a><a href="http://prim.iledefrance-mobilites.fr/apis/idfm-ivtr-requete_unitaire" rel="noreferrer">next</a><a href="http://prim.iledefrance-mobilites.fr/apis/idfm-ivtr-requete_unitaire" rel="noreferrer"> </a><a href="http://prim.iledefrance-mobilites.fr/apis/idfm-ivtr-requete_unitaire" rel="noreferrer">passages</a><a href="http://prim.iledefrance-mobilites.fr/apis/idfm-ivtr-requete_unitaire" rel="noreferrer">to</a><a href="http://prim.iledefrance-mobilites.fr/apis/idfm-ivtr-requete_unitaire" rel="noreferrer"> </a><a href="http://prim.iledefrance-mobilites.fr/apis/idfm-ivtr-requete_unitaire" rel="noreferrer">un</a><a href="http://prim.iledefrance-mobilites.fr/apis/idfm-ivtr-requete_unitaire" rel="noreferrer"> </a><a href="http://rec.prim.iledefrance-mobilites.fr/apis/idfm-ivtr-requete_unitaire?ref=prim.iledefrance-mobilites.fr" rel="noreferrer">arrêt</a><a href="http://prim.iledefrance-mobilites.fr/apis/idfm-ivtr-requete_unitaire" rel="noreferrer"> </a><a href="http://prim.iledefrance-mobilites.fr/apis/idfm-ivtr-requete_unitaire" rel="noreferrer">particulier</a></li></ul>Other available data useful for requesting Next Departures APIs:To find out about data relating to referentials (stops and Lines), available on the Île-de-France Mobilités portal, follow <a href="http://prim.iledefrance-mobilites.fr/en/jeux-de-donnees/perimetre-des-donnees-tr-disponibles-plateforme-idfm?staticDataSlug=perimetre-des-donnees-tr-disponibles-plateforme-idfm" rel="noreferrer">ce</a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/perimetre-des-donnees-tr-disponibles-plateforme-idfm?staticDataSlug=perimetre-des-donnees-tr-disponibles-plateforme-idfm" rel="noreferrer">link</a>.The list of available data is updated weekly.<ul><li>The standards portal for public transport supply data: <a href="http://www.normes-donnees-tc.org/?ref=prim.iledefrance-mobilites.fr" rel="noreferrer">http://www.normes-donnees-tc.org/</a></li><li>Data profile: the SIRI Lite</li>Schedule format: yyyy-mm-dd 'T' hh:mm:ss.SSSZ</li></ul>

Service description

<h3 id="identification-des-lignes">Lines identification</h3>The identifier of a line "LineRef"must be passed in the form:STIF:Line::CXXXXX: with CXXXXX the line identifier in the <a href="https://data.iledefrance-mobilites.Lines/explore/dataset/referential-of-lines/table?ref=prim.iledefrance-mobilites.fr" rel="noreferrer">Referential</a><a href="https://data.iledefrance-mobilites.fr/explore/dataset/referentiel-des-lignes/table?ref=prim.iledefrance-mobilites.fr" rel="noreferrer"> </a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/referentiel-des-lignes" rel="noreferrer">Île-de-France</a><a href="https://data.iledefrance-mobilites.fr/explore/dataset/referentiel-des-lignes/table?ref=prim.iledefrance-mobilites.fr" rel="noreferrer"> </a><a href="https://data.iledefrance-mobilites.fr/explore/dataset/referentiel-des-lignes/table?ref=prim.iledefrance-mobilites.fr" rel="noreferrer">Mobilités</a>Examples: <ul><li>For RER Line B, the line identifier in the Île-de-France Mobilités Referential is C01743, so the pattern is "STIF:Line::C01743:".</li><li>For the Phébus A bus line, the line identifier in the Île-de-France Mobilité referential is C00692, so the pattern is "STIF:Line::C00692:".</li></ul><h3 id="identification-des-arr%C3%AAts">Stop identification</h3>The identifier of a stop "MonitoringRef_ZDE"must be passed in the form:STIF:StopPoint:Q:XXXXX: with XXXXX the identifier of the <a href="https://data.iledefrance-mobilites.fr/explore/dataset/arrets/table/?ref=prim.iledefrance-mobilites.fr" rel="noreferrer">referential</a><a href="https://data.iledefrance-mobilites.fr/explore/dataset/arrets/table/?ref=prim.iledefrance-mobilites.fr" rel="noreferrer"> </a><a href="https://data.iledefrance-mobilites.fr/explore/dataset/arrets/table/?ref=prim.iledefrance-mobilites.fr" rel="noreferrer">of the stops</a>Examples:For the stop "Gare de Massy-Palaiseau" on the Lines B of the RER, the referential identifier is 412833, the pattern is "STIF:StopPoint:Q:412833:".

Object identification

<ul><li>Estimation deviation</li></ul>Next passages are forecast data and therefore by definition a deviation may be encountered between the estimate and the actual passage. Accuracy degrades with time, particularly beyond 20 minutes for buses and 30 minutes for rail.<ul><li>Passage times</li></ul>As long as the vehicle has not started its run, the system provides the passage times planned by the operator the day before the current day.<ul><li>Data depth</li></ul>For all modes, data is available to a maximum depth of three hours for carriers that allow it.<ul><li>Passage prediction</li></ul>Bus mode : passage prediction at a stop based on bus location taking into account previous journeys.Rail mode : passage prediction at a stop based on vehicle location.

Focus on global and unitary queries

<h2 id="service-prochains-passages-%E2%80%93-requ%C3%AAte-unitaire%E2%80%8B">Next Departures Service - Unitary query</h2><h3 id="stop-requis%E2%80%8B">Stop (required)</h3>This service provides the next transit times in real time for a given stop.The tolerated call parameters are all the stop levels described in the Île-de-France Stops Referential (arrets.xls), namely:<ul><li>ARr, boarding zone (formerly ZDER): "STIF:StopPoint:Q:[ArRId]:" Example: Platforms M4 - Châtelet: STIF:StopPoint:22092: (outbound) and STIF:StopPoint:463158: (return)</li></ul>Attention:A platform contains 2 different boarding zone identifiers (ArRId): one for the outbound direction and one for the return direction. A query on a platform will return the next passages in a single direction.For RER and Transilien stations, SNCF populates data at a fictitious ArR that represents the entire station.--Prefer queries to ZdA / ZdC<ul><li>ZdA , monomodal stop zone (formerly ZDL : Zone de lieu) : "STIF:StopArea:SP:[ZdAId]:" Example Metro - Châtelet stop zone : STIF:StopArea:SP:42587:</li><li>ZdC (multimodal transfer zone)"STIF:StopArea:SP:[ZdCId]:"Example Transfer Zone - Châtelet : STIF:StopArea:SP:71264:</li></ul>To note:<ul><li>The dataset <a href="http://prim.iledefrance-mobilites.fr/en/datasets/arrets?staticDataSlug=arrets" rel="noreferrer">Referential</a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/arrets?staticDataSlug=arrets" rel="noreferrer"> </a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/arrets?staticDataSlug=arrets" rel="noreferrer">of</a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/arrets?staticDataSlug=arrets" rel="noreferrer"> </a><a href="http://prim.iledefrance-mobilites.fr/en/jeux-de-donnees/arrets?staticDataSlug=arrets" rel="noreferrer">arrêts</a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/arrets?staticDataSlug=arrets" rel="noreferrer"> </a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/arrets?staticDataSlug=arrets" rel="noreferrer">:</a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/arrets?staticDataSlug=arrets" rel="noreferrer"> </a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/arrets?staticDataSlug=arrets" rel="noreferrer">Stops</a><a href="http://prim.iledefrance-mobilites.fr/en/datasets/arrets?staticDataSlug=arrets" rel="noreferrer"> </a>proposes the reference stops of the Île-de-France stops referential.</li><li>The dataset <a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/relations?staticDataSlug=relations" rel="noreferrer">Referential</a><a href="http://prim.iledefrance-mobilites.fr/en/jeux-de-donnees/relations?staticDataSlug=relations" rel="noreferrer"> </a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/relations?staticDataSlug=relations" rel="noreferrer">des</a><a href="http://prim.iledefrance-mobilites.fr/en/data-games/relations?staticDataSlug=relations" rel="noreferrer"> </a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/relations?staticDataSlug=relations" rel="noreferrer">stops</a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/relations?staticDataSlug=relations" rel="noreferrer"> </a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/relations?staticDataSlug=relations" rel="noreferrer">:</a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/relations?staticDataSlug=relations" rel="noreferrer"> </a><a href="http://prim.iledefrance-mobilites.fr/en/jeux-de-donnees/relations?staticDataSlug=relations" rel="noreferrer">Relations</a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/relations?staticDataSlug=relations" rel="noreferrer"> </a>proposes all the relationships between objects in the Île-de-France Stops referential.</li><li>The dataset <a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/perimetre-des-donnees-tr-disponibles-plateforme-idfm?staticDataSlug=perimetre-des-donnees-tr-disponibles-plateforme-idfm" rel="noreferrer">Perimeter</a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/perimetre-des-donnees-tr-disponibles-plateforme-idfm?staticDataSlug=perimetre-des-donnees-tr-disponibles-plateforme-idfm" rel="noreferrer"> </a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/perimetre-des-donnees-tr-disponibles-plateforme-idfm?staticDataSlug=perimetre-des-donnees-tr-disponibles-plateforme-idfm" rel="noreferrer">des</a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/perimetre-des-donnees-tr-disponibles-plateforme-idfm?staticDataSlug=perimetre-des-donnees-tr-disponibles-plateforme-idfm" rel="noreferrer"> </a><a href="http://prim.iledefrance-mobilites.fr/fr/dataasets/perimeter-of-data-tr-available-idfm-platform?staticDataSlug=perimeter-of-data-tr-available-idfm-platform" rel="noreferrer">data</a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/perimetre-des-donnees-tr-disponibles-plateforme-idfm?staticDataSlug=perimetre-des-donnees-tr-disponibles-plateforme-idfm" rel="noreferrer"> </a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/perimetre-des-donnees-tr-disponibles-plateforme-idfm?staticDataSlug=perimetre-des-donnees-tr-disponibles-plateforme-idfm" rel="noreferrer">time</a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/perimetre-des-donnees-tr-disponibles-plateforme-idfm?staticDataSlug=perimetre-des-donnees-tr-disponibles-plateforme-idfm" rel="noreferrer"> </a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/perimetre-des-donnees-tr-disponibles-plateforme-idfm?staticDataSlug=perimetre-des-donnees-tr-disponibles-plateforme-idfm" rel="noreferrer">réel</a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/perimetre-des-donnees-tr-disponibles-plateforme-idfm?staticDataSlug=perimetre-des-donnees-tr-disponibles-plateforme-idfm" rel="noreferrer"> </a><a href="http://prim.iledefrance-mobilites.fr/en/jeux-de-donnees/perimetre-des-donnees-tr-disponibles-plateforme-idfm?staticDataSlug=perimetre-des-donnees-tr-disponibles-plateforme-idfm" rel="noreferrer">disponibles</a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/perimetre-des-donnees-tr-disponibles-plateforme-idfm?staticDataSlug=perimetre-des-donnees-tr-disponibles-plateforme-idfm" rel="noreferrer"> </a>exposes the list of stops by Lines/carrier concerned by this service.</li><li>The dataset <a href="http://prim.iledefrance-mobilites.fr/jeux-de-donnees/arrets-lignes" rel="noreferrer">Stops et lignes associées</a> lists all the Lines in the Ile-de-France network and the Stops served for each of these lines as in the GTFS.</li></ul><h3 id="%E2%80%8B%E2%80%8Bligne-optionnel%E2%80%8B">Ligne (optional)</h3>This service provides real-time next Departures times for a given stop, for a given line.The tolerated call parameters are the Lines described in the <a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/referentiel-des-lignes?staticDataSlug=referentiel-des-lignes" rel="noreferrer">Referential</a><a href="http://prim.iledefrance-mobilites.fr/en/jeux-de-donnees/referentiel-des-lignes?staticDataSlug=referentiel-des-lignes" rel="noreferrer"> </a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/referentiel-des-lignes?staticDataSlug=referentiel-des-lignes" rel="noreferrer">des</a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/referentiel-des-lignes?staticDataSlug=referentiel-des-lignes" rel="noreferrer"> </a><a href="http://rec.prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/referentiel-des-lignes?staticDataSlug=referentiel-des-lignes&ref=prim.iledefrance-mobilites.fr" rel="noreferrer">lines</a><a href="http://prim.iledefrance-mobilites.fr/en/jeux-de-donnees/referentiel-des-lignes?staticDataSlug=referentiel-des-lignes" rel="noreferrer"> </a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/referentiel-des-lignes?staticDataSlug=referentiel-des-lignes" rel="noreferrer">de</a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/referentiel-des-lignes?staticDataSlug=referentiel-des-lignes" rel="noreferrer"> </a><a href="http://rec.prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/referentiel-des-lignes?staticDataSlug=referentiel-des-lignes&ref=prim.iledefrance-mobilites.fr" rel="noreferrer">transport</a><a href="http://prim.iledefrance-mobilites.fr/en/jeux-de-donnees/referentiel-des-lignes?staticDataSlug=referentiel-des-lignes" rel="noreferrer"> </a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/referentiel-des-lignes?staticDataSlug=referentiel-des-lignes" rel="noreferrer">en</a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/referentiel-des-lignes?staticDataSlug=referentiel-des-lignes" rel="noreferrer"> </a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/referentiel-des-lignes?staticDataSlug=referentiel-des-lignes" rel="noreferrer">commun</a><a href="http://prim.iledefrance-mobilites.fr/en/jeux-de-donnees/referentiel-des-lignes?staticDataSlug=referentiel-des-lignes" rel="noreferrer"> </a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/referentiel-des-lignes?staticDataSlug=referentiel-des-lignes" rel="noreferrer">d'Île</a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/referentiel-des-lignes?staticDataSlug=referentiel-des-lignes" rel="noreferrer">-de-France</a>, namely:<ul><li>ID_Line, commercial line reference identifier: "STIF:Line::[ID_Line]:" Example RER C line: STIF:Line::C01727:</li></ul><h2 id="service-prochains-passages-%E2%80%93-requ%C3%AAte-globale%E2%80%8B">Service Prochains passages - Requête globale</h2><h3 id="all-requis%E2%80%8B">ALL (requis)</h3>This service provides real-time Next Departures schedules for all network Stops.The only tolerated call parameter is: ALL. Example: LineRef=ALLWarning:The query wizard available on the PRIM platform cannot be used for the global query, due to the size of its response. We recommend that you query this API via a query interface or a script.To note:The dataset <a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/perimetre-des-donnees-tr-disponibles-plateforme-idfm?staticDataSlug=perimetre-des-donnees-tr-disponibles-plateforme-idfm" rel="noreferrer">Perimeter</a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/perimetre-des-donnees-tr-disponibles-plateforme-idfm?staticDataSlug=perimetre-des-donnees-tr-disponibles-plateforme-idfm" rel="noreferrer"> </a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/perimetre-des-donnees-tr-disponibles-plateforme-idfm?staticDataSlug=perimetre-des-donnees-tr-disponibles-plateforme-idfm" rel="noreferrer">of</a><a href="http://prim.iledefrance-mobilites.fr/fr/jeux-de-donnees/perimetre-des-donnees-tr-disponibles-plateforme-idfm?staticDataSlug=perimetre-des-donnees-tr-disponibles-plateforme-idfm" rel="noreferr

Query structure - Call parameters

<blockquote>Query : https://prim.iledefrance-mobilites.fr/marketplace/stop-monitoring?MonitoringRef=STIF:StopPoint:Q:463158:</blockquote><blockquote>Attention : </blockquote><blockquote>The time displayed in the ResponseTimestamp field is expressed in local<a href="https://time.is/fr/Paris?ref=prim.iledefrance-mobilites.fr"> time</a> (in summer GMT+02, winter GMT+01). All other times are expressed in&nbsp; <a href="https://time.is/fr/GMT?ref=prim.iledefrance-mobilites.fr">GMT</a>.</blockquote><figure class="kg-card kg-image-card"><img src="http://prim.iledefrance-mobilites.fr/content/images/2024/10/image---2024-10-09T105346.089.png" class="kg-image" alt="" loading="lazy" width="745" height="532" srcset="http://prim.iledefrance-mobilites.fr/content/images/size/w600/2024/10/image---2024-10-09T105346.089.png 600w, http://prim.iledefrance-mobilites.fr/content/images/2024/10/image---2024-10-09T105346.089.png 745w" sizes="(min-width: 720px) 720px"></figure>

<style type="text/css">
.tg {border-collapse:collapse;border-spacing:0;}
.tg td{border-color:black;border-style:solid;border-width:1px;font-family:Arial, sans-serif;font-size:14px;
 overflow:hidden;padding:10px 5px;word-break:normal;}
.tg th{border-color:black;border-style:solid;border-width:1px;font-family:Arial, sans-serif;font-size:14px;
 font-weight:normal;overflow:hidden;padding:10px 5px;word-break:normal;}
.tg .tg-fymr{border-color:inherit;font-weight:bold;text-align:left;vertical-align:top}
.tg .tg-0pky{border-color:inherit;text-align:left;vertical-align:top}
</style>
<table class="tg"><thead>
 <tr>
 <th class="tg-fymr">Number</th>
 <th class="tg-fymr">Description</th>
 </tr></thead>
<tbody>
 <tr>
 <td class="tg-0pky">1</td>
 <td class="tg-0pky">Time of response</td>
 </tr>
 <tr>
 <td class="tg-0pky">2</td>
 <td class="tg-0pky">Description of Stops</td>
 </tr>
 <tr>
 <td class="tg-0pky">3</td>
 <td class="tg-0pky">Date and time this data was produced</td>
 </tr>
 <tr>
 <td class="tg-0pky">4</td>
 <td class="tg-0pky">Identifier of the Stops concerned by the query</td>
 </tr>
 <tr>
 <td class="tg-0pky">5</td>
 <td class="tg-0pky">Race description</td>
 </tr>
 <tr>
 <td class="tg-0pky">6</td>
 <td class="tg-0pky">Route identifier Responses to queries about multi-line Stops (single-mode or multi-mode zones) will need to be filtered on the LineRef.</td>
 </tr>
 <tr>
 <td class="tg-0pky">7</td>
 <td class="tg-0pky">Operator identifier (operator)</td>
 </tr>
 <tr>
 <td class="tg-0pky">8</td>
 <td class="tg-0pky">Race identifier</td>
 </tr>
 <tr>
 <td class="tg-0pky">9</td>
 <td class="tg-0pky">Race identification context</td>
 </tr>
 <tr>
 <td class="tg-0pky">10</td>
 <td class="tg-0pky">Race identifier</td>
 </tr>
 <tr>
 <td class="tg-0pky">11</td>
 <td class="tg-0pky">Management name</td>
 </tr>
</tbody></table>

<figure class="kg-card kg-image-card"><img src="http://prim.iledefrance-mobilites.fr/content/images/2024/10/image-2--2-.png" class="kg-image" alt="" loading="lazy" width="595" height="522"></figure>

<style type="text/css">
.tg {border-collapse:collapse;border-spacing:0;}
.tg td{border-color:black;border-style:solid;border-width:1px;font-family:Arial, sans-serif;font-size:14px;
 overflow:hidden;padding:10px 5px;word-break:normal;}
.tg th{border-color:black;border-style:solid;border-width:1px;font-family:Arial, sans-serif;font-size:14px;
 font-weight:normal;overflow:hidden;padding:10px 5px;word-break:normal;}
.tg .tg-1wig{font-weight:bold;text-align:left;vertical-align:top}
.tg .tg-0lax{text-align:left;vertical-align:top}
</style>
<table class="tg"><thead>
 <tr>
 <th class="tg-1wig">Number</th>
 <th class="tg-1wig">Description</th>
 </tr></thead>
<tbody>
 <tr>
 <td class="tg-0lax">12</td>
 <td class="tg-0lax">Identifier of the last Stops in the race</td>
 </tr>
 <tr>
 <td class="tg-0lax">13</td>
 <td class="tg-0lax">Name of destination Stops</td>
 </tr>
 <tr>
 <td class="tg-0lax">14</td>
 <td class="tg-0lax">Additional text describing the run</td>
 </tr>
 <tr>
 <td class="tg-0lax">15</td>
 <td class="tg-0lax">Hourly information concerning the considered Stops</td>
 </tr>
 <tr>
 <td class="tg-0lax">16</td>
 <td class="tg-0lax">Stop name</td>
 </tr>
 <tr>
 <td class="tg-0lax">17</td>
 <td class="tg-0lax">The value true indicates that the vehicle is at Stops. Default value: false</td>.
 </tr>
 <tr>
 <td class="tg-0lax">18</td>
 <td class="tg-0lax">Destination as displayed on the vehicle's windvane at this Stops (or on the local display)</td>
 </tr>
 <tr>
 <td class="tg-0lax">19</td>
 <td class="tg-0lax">Arrival time estimated by SAE</td>
 </tr>
 <tr>
 <td class="tg-0lax">20</td>
 <td class="tg-0lax">Departure time estimated by SAE</td>
 </tr>
 <tr>
 <td class="tg-0lax">21</td>
 <td class="tg-0lax">Characterization of the expected departure time (or measured if the vehicle is docked). Default value: onTime. If the passage is deleted, the value is cancelled.</td>.
 </tr>
</tbody></table>

Sample answers - Quay level (return)

<h3 id="aimedarrival-departuretime-%E2%80%8B">AimedArrival/ DepartureTime: </h3>Theoretical departure and arrival timetables established the day before by the carrier, taking into account driver and vehicle availability. These schedules are not always available.<h3 id="expectedarrival-departuretime-%E2%80%8B">ExpectedArrival/ DepartureTime: </h3>Predicted times of next departures taking into account the actual position of the vehicle, the time remaining to reach a stop and the travel times observed on previous journeys.<h3 id="arrival-departurestatus-%E2%80%8B">Arrival/ DepartureStatus: </h3>Characterize the expected (or measured if the vehicle is docked) departure or arrival times.These fields can take the following values:<ul><li>onTime : At the scheduled time</li><li>early : In advance</li><li>delayed : Delayed</li><li>cancelled : Passage to a canceled Stops (does not concern the entire journey).</li><li>missed : The vehicle did not mark the stop when it should have, but the run continues.</li><li>arrived : Arrived</li><li>departed : Parti</li><li>notExpected : Not planned (case of TAD not yet triggered)</li><li>noReport : Not communicated Default value : "onTime".</li></ul>Caution: The API response contains data from 30 minutes before the time of the request and up to 2 hours after.<h3 id="directionref">DirectionRef:</h3>There is no referential&nbsp; shared across Île-de-France Mobilités, so the&nbsp; field is optional. However, the "DestinationRef"&nbsp; (race terminus) field is always filled in.<h3 id="datedvehiclejourney-ref">DatedvehicleJourney&nbsp; Ref:</h3>The race identifier uniquely identifiesa&nbsp; race for all carriers. In a response to a global query, the run&nbsp;is reconstructed because we&nbsp; get the next passages at all the Stops on that run.<h3 id="vehiclefeatureref">VehicleFeatureRef:</h3>Indicates the length of the trains. This field can take two values:<ul><li>The value "shortTrain " signals that it &nbsp;is a short train.</li><li>The value "longTrain " signals that it &nbsp;is a long train.</li></ul>However, this field is optional for&nbsp;carriers, so if it doesn't appear in the response it means that the carrier hasn't transmitted&nbsp;the information.Please note: RATP does not supply run identifiers, but a technical counter with no business link to the notion of a run.We then obtain in the global query response for the same Lines and direction all vehicles stopping at the same&nbsp;time whatever the Stops. As a result, in global query responses, RATP runs are not correctly reconstructed. Next Departures at Stops are, however, all populated in the response.

Taking the answer into account

Next Departures APIs

The data is updated daily.&nbsp;The data covers the next three weeks.The full timetables for RER A and B are transmitted by SNCF.The timetables for the SNCF Lines include adaptations made during planned works, as well as substitutions made by bus (e.g. a bus journey will be offered if a section is cut due to works).The timetables for RATP lines do notin generalinclude adaptations made during planned works.&nbsp; (ex: Closure of a metro station).Contrary to files from GTFS, the data from APIs take into account Local Traffic Interdictions (ITL) which sometimes exist on certain OPTILE bus lines..

Data quality

<h3 id="route">route</h3>A "&nbsp;route&nbsp;" is a set of routes grouped under the same name, this object refers to the line identifier available in the <a href="https://data.iledefrance-mobilites.fr/explore/dataset/referentiel-des-lignes/information/?ref=prim.iledefrance-mobilites.fr">lines referential</a>.&nbsp;Ex: IDFM:C01371 (Métro 1)<h3 id="trip">trip</h3>A "&nbsp;trip&nbsp;" defines a route on a given Lines, it is a structured sequence of Stops. Ex: IDFM:RATP:9541-C01371-10_3736592_955496 (Métro 1 - Sens la Défense)<h3 id="service">service</h3>A "&nbsp;service&nbsp;" trip is the variation of a route at a given time. A run assigns each stop on the route a transit time.Over the course of a day, a run is unique: two vehicles on the same Lines each run a different run.Ex: IDFM:100071 (Métro 1 - a run that only runs on Saturdays from August 21, 2021 to August 28, 2021)<h3 id="agency">agency</h3>An "&nbsp;agency&nbsp;" is a commercial network or transport operator.Ex :&nbsp; IDFM:1051 (Poissy - Les Mureaux) or IDFM:Operator_100 (RATP)<h3 id="stop">stop</h3>A "&nbsp;stop&nbsp;" is an object that describes a type of stop, it is :<ol><li>A single carrier's stop point, for this case it takes the following forms:</li></ol><ul><li>StopPoint Ferré (RER,Transilien): "IDFM:[ID ZdA]"</li><li>StopPoint (rest): "IDFM:[ID ArR]"</li></ul>Ex : IDFM:3640 (Jean de La Fontaine)<ol start="2"><li> A "&nbsp;stop_area&nbsp;" is a grouping of physical stops bearing the same name also known as a commercial stop:</li></ol><ul><li>StopArea : "IDFM:[ID ZdC]"</li></ul>Ex: IDFM:70604 (Porte de Choisy)Note:"&nbsp;stop_point&nbsp;" is a non-permanent data for the bus. It is likely to be changed every day when the GTFS is published. The"&nbsp;stop_points&nbsp;" are rather stable for the rail network.

Call settings

The {URI} parameter means that the call parameters are embedded in the query URL and are not, as in most cases, at the end of the query URL.Example&nbsp;: To retrieve all the "&nbsp;stop_points&nbsp;" on metro line 1 (line:IDFM:C01373 )We use the method : /v2/navitia/{uri}/stop_points/{id}&nbsp;With the call parameter in place of {id}: lines%2Fline:IDFM:C01373&nbsp;

Use {URI} parameter in Navitia generic API

The <a href="http://prim.iledefrance-mobilites.fr/playground/index.html" rel="noreferrer">playground of Navitia</a> is an interactive tool&nbsp;allowing to test and explore the APIs <a href="http://prim.iledefrance-mobilites.fr/fr/apis/idfm-navitia-general-v2" rel="noreferrer">Calculator Ile-de-France Mobilités - Generic Access (v2)</a>, <a href="http://prim.iledefrance-mobilites.fr/en/apis/idfm-navitia-isochrones-v2" rel="noreferrer">Calculator Ile-de-France Mobilités - Isochrones (idfm coverage)</a> and <a href="http://prim.iledefrance-mobilites.fr/fr/apis/idfm-navitia-line_reports-v2" rel="noreferrer">Calculator Ile-de-France Mobilités - Trafic messages (idfm coverage)</a>.In order to use the playground integrated on PRIM, you will be asked for a token. You can use your API token available on PRIM or generate it by following <a href="http://prim.iledefrance-mobilites.fr/fr/aide-et-contact/documentation/donnees-disponibles/api/generer-un-jeton-pour-acceder-aux-api" rel="noreferrer">this documentation</a>.<h2 id="la-page-daccueil">The home page</h2><figure class="kg-card kg-image-card"><img src="http://prim.iledefrance-mobilites.fr/content/images/2024/11/playground.jpg" class="kg-image" alt="" loading="lazy" width="1372" height="647" srcset="http://prim.iledefrance-mobilites.fr/content/images/size/w600/2024/11/playground.jpg 600w, http://prim.iledefrance-mobilites.fr/content/images/size/w1000/2024/11/playground.jpg 1000w, http://prim.iledefrance-mobilites.fr/content/images/2024/11/playground.jpg 1372w" sizes="(min-width: 720px) 720px"></figure>1: Access several popular sample queries to quickly retrieve certain information. 2: Fill in the PRIM URL of the desired environment, click GO and start using the preconfigured Playground to query this URL.3: Access the Playground page directly without any preconfiguration.4: View a response from a previously downloaded JSON file. <h2 id="la-page-principale">The main page </h2>The main Playground page lets you configure the various requests and view their response.<figure class="kg-card kg-image-card"><img src="http://prim.iledefrance-mobilites.fr/content/images/2024/11/main-page.png" class="kg-image" alt="" loading="lazy" width="1750" height="928" srcset="http://prim.iledefrance-mobilites.fr/content/images/size/w600/2024/11/main-page.png 600w, http://prim.iledefrance-mobilites.fr/content/images/size/w1000/2024/11/main-page.png 1000w, http://prim.iledefrance-mobilites.fr/content/images/size/w1600/2024/11/main-page.png 1600w, http://prim.iledefrance-mobilites.fr/content/images/2024/11/main-page.png 1750w" sizes="(min-width: 720px) 720px"></figure><h3 id="1les-champs-api-et-token">1 - The API and Token fields </h3><ul><li>The API field describes the URL allowing the preconfigured Playground to be used from this URL. It will always be <a href="http://prim.iledefrance-mobilites.fr/marketplace/v2">https://prim.iledefrance-mobilites.fr/marketplace/v2</a>.</li><li>The Token field corresponds to the token you generated on the PRIM platform.</li></ul><h3 id="2le-champ-navitia">2 - The Navitia field</h3>The Navitia field is used to indicate the Navitia API you wish to request.By default, without a value filled in, this will call the API Calculator Ile-de-France Mobilités - Accès générique (coverage idfm).

<style type="text/css">
.tg {border-collapse:collapse;border-spacing:0;}
.tg td{border-color:black;border-style:solid;border-width:1px;font-family:Arial, sans-serif;font-size:14px;
 overflow:hidden;padding:10px 5px;word-break:normal;}
.tg th{border-color:black;border-style:solid;border-width:1px;font-family:Arial, sans-serif;font-size:14px;
 font-weight:normal;overflow:hidden;padding:10px 5px;word-break:normal;}
.tg .tg-wp8o{border-color:#000000;text-align:center;vertical-align:top}
</style>
<table class="tg"><thead>
 <tr>
 <th class="tg-wp8o">Informed value</th>
 <th class="tg-wp8o">API called</th>
 </tr></thead>
<tbody>
 <tr>
 <td class="tg-wp8o">N/A</td>
 <td class="tg-wp8o">Calculator Ile-de-France Mobilités - Generic access (idfm coverage)</td>
 </tr>
 <tr>
 <td class="tg-wp8o">isochrones</td>
 <td class="tg-wp8o">Calculator Ile-de-France Mobilités - Isochrones (idfm coverage)</td>
 </tr>
 <tr>
 <td class="tg-wp8o">line_reports</td>
 <td class="tg-wp8o">Calculator Ile-de-France Mobilités - Trafic messages (coverage idfm)</td>
 </tr>
</tbody>
</table>

To request the API Calculator Ile-de-France Mobilités - Trafic messages (coverage idfm), it is necessary to line-reports field 2 times:<ul><li>In the Feature field, as for normal operation</li><li>In the Navitia</li></ul>This generates a duplicate line_reports string in the final URL, which is desired for the proper operation of this API. The count parameter of the API Calculator Ile-de-France Mobilités - Trafic messages (coverage idfm) is capped at 100 on PRIM.To request the API Calculator Ile-de-France Mobilités - Isochrones (coverage idfm), it is also necessary to rense the isochrones field twice in the Feature and Navitia fields.<h3 id="3le-champ-path">3 - The Path field</h3>The path field is used to filter the response, which will be obtained via various filters such as the mode of transport used, the transport line or the Stops. It works with a system of keys and values, both of which are autocomplete.<example: Possible values for the path physical_modes: <figure class="kg-card kg-image-card"><img src="http://prim.iledefrance-mobilites.fr/content/images/2024/11/physical-mode.png" class="kg-image" alt="" loading="lazy" width="405" height="373"></figure><h3 id="4the-feature-field">4 - The Feature field</h3>The feature field is used to specify the type of search in the Calculator. An autocomplete is set up to indicate the different features available. Example : Features available for the Navitia Journeys API:<figure class="kg-card kg-image-card"><img src="http://prim.iledefrance-mobilites.fr/content/images/2024/11/feature.png" class="kg-image" alt="" loading="lazy" width="529" height="401"></figure><h3 id="5les-champs-parameters">5 - Parameters fields </h3>The fields allow you to specify the parameters of the search entered via the Feature field. They work with a key and value system, both of which are autocomplete.<figure class="kg-card kg-image-card"><img src="http://prim.iledefrance-mobilites.fr/content/images/2024/11/param-key.png" class="kg-image" alt="" loading="lazy" width="438" height="257"></figure><figure class="kg-card kg-image-card"><img src="http://prim.iledefrance-mobilites.fr/content/images/2024/11/param-value.png" class="kg-image" alt="" loading="lazy" width="698" height="434" srcset="http://prim.iledefrance-mobilites.fr/content/images/size/w600/2024/11/param-value.png 600w, http://prim.iledefrance-mobilites.fr/content/images/2024/11/param-value.png 698w"></figure><h3 id="6r%C3%A9capitulatif-de-lurl-finale">6 - Final URL summary</h3>On clicking the Submit button, the parameterized URL is called up.It is automatically updated according to the parameters selected in the previous fields.To ensure that the tool functions correctly, the URL format must always respect the following format: https://prim.iledefrance-mobilites.fr/marketplace/v2/navitia/${API_NAVITIA}/${PATH}/${FEATURE}?${QUERY_PARAMS}<h3 id="7visualisation-de-la-r%C3%A9ponse">7 - Viewing the response</h3>Once the request has been made, the response is formatted for viewing in this section. It is possible to unfold each part corresponding to subsections of the original JSON and view them in several forms ( JSON, maps etc.).

Using the Playground

APIs Calculator Île-de-France Mobilités

<h2 id="optimiser-vos-requ%C3%AAtes-d%E2%80%99appel-%C3%A0-l%E2%80%99api-calculateur-ile-de-france-mobilite%CC%81smessages-info-trafic-v2">Optimize your call requests to the Ile-de-France Mobilités Calculator API - Trafic messages (v2)</h2>As a reminder:The number of elements returned for a request may not exceed 100. If you ask for more, the API will return the first 100 results, and you'll have to paginate using the start_page parameter to get the next 100.We recommend adding some of the available parameters to your queries to get more precise responses that really fit your needs.Some examples of queries with the {URI} parameter to refine your searches (method: /v2/navitia/{uri}/line_reports)1- Objective: &nbsp;To retrieve traffic info for all "&nbsp;stop_points&nbsp;" on a lineExample query for RER C (line:IDFM:C01727): <a href="http://prim.iledefrance-mobilites.fr/marketplace/v2/navitia/line_reports/lines/line%3AIDFM%3AC01727/line_reports?count=100">https://prim.iledefrance-mobilites.fr/marketplace/v2/navitia/line_reports/lines/line%3AIDFM%3AC01727/line_reports?count=100</a>2- Objective: &nbsp;To retrieve traffic info for a particular mode of transportExample query for mode "&nbsp;metro&nbsp;": <a href="http://prim.iledefrance-mobilites.fr/marketplace/v2/navitia/line_reports/physical_modes/physical_mode%3AMetro/line_reports?count=100">https://prim.iledefrance-mobilites.fr/marketplace/v2/navitia/line_reports/physical_modes/physical_mode%3AMetro/line_reports?count=100</a>3- Objective: &nbsp;Retrieve all traffic info with exception:&nbsp;Example query to retrieve all traffic info except bus : <a href="http://prim.iledefrance-mobilites.fr/marketplace/v2/navitia/line_reports/line_reports?count=100&forbidden_uris%5B%5D=physical_mode%3ABus">https://prim.iledefrance-mobilites.fr/marketplace/v2/navitia/line_reports/line_reports?count=100&amp;forbidden_uris%5B%5D=physical_mode%3ABus</a>

API Calculator Ile-de-France Mobilités - Trafic messages (v2)

<h2 id="mapping-entre-lapi-calculateur-ile-de-france-mobilite%CC%81smessages-info-trafic-v2-et-lapi-messages-info-traficrequ%C3%AAte-globale">Mapping between API Calculator Ile-de-France Mobilités - Trafic Info Messages (v2) and API Trafic Info Messages - Global Query</h2><h3 id="lines-impact%C3%A9es">Lines impacted </h3>

<style type="text/css">
.tg {border-collapse:collapse;border-spacing:0;}
.tg td{border-color:black;border-style:solid;border-width:1px;font-family:Arial, sans-serif;font-size:14px;
 overflow:hidden;padding:10px 5px;word-break:normal;}
.tg th{border-color:black;border-style:solid;border-width:1px;font-family:Arial, sans-serif;font-size:14px;
 font-weight:normal;overflow:hidden;padding:10px 5px;word-break:normal;}
.tg .tg-1wig{font-weight:bold;text-align:left;vertical-align:top}
.tg .tg-0lax{text-align:left;vertical-align:top}
</style>
<table class="tg"><thead>
 <tr>
 <th class="tg-0lax"></th>
 <th class="tg-1wig">Description</th>
 <th class="tg-1wig">API Line_Reports</th>
 <th class="tg-1wig">Example value</th>
 <th class="tg-1wig">API Bulk Disruptions</th>
 <th class="tg-1wig">Example value</th>
 </tr></thead>
<tbody>
 <tr>
 <td class="tg-0lax">1</td>
 <td class="tg-0lax">Line identifier</td>
 <td class="tg-0lax">line.id</td>
 <td class="tg-0lax">line:IDFM:C01110</td>
 <td class="tg-0lax">lines.id</td>
 <td class="tg-0lax">line:IDFM:C01110</td>
 </tr>
 <tr>
 <td class="tg-0lax">2</td>
 <td class="tg-0lax">Line name</td>
 <td class="tg-0lax">line.name</td>
 <td class="tg-0lax">75</td>
 <td class="tg-0lax">lines.name</td>
 <td class="tg-0lax">75</td>
 </tr>
 <tr>
 <td class="tg-0lax">3</td>
 <td class="tg-0lax">Short name of the Lines</td>
 <td class="tg-0lax">line.code</td>
 <td class="tg-0lax">75</td>
 <td class="tg-0lax">lines.shortName</td>
 <td class="tg-0lax">75</td>
 </tr>
 <tr>
 <td class="tg-0lax">4</td>
 <td class="tg-0lax">Mode</td>
 <td class="tg-0lax">line.physical_modes.id</td>
 <td class="tg-0lax">Bus</td>
 <td class="tg-0lax">lines.mode</td>
 <td class="tg-0lax">Bus</td>
 </tr>
 <tr>
 <td class="tg-0lax">5</td>
 <td class="tg-0lax">Network identifier</td>
 <td class="tg-0lax">line.network.id</td>
 <td class="tg-0lax">network:IDFM:Operator_100</td>
 <td class="tg-0lax">lines.networkId</td>
 <td class="tg-0lax">network:IDFM:Operator_100</td>
 </tr>
</tbody></table>

<h3 id="objects-impact%C3%A9s">Objects impacted</h3>

<style type="text/css">
.tg {border-collapse:collapse;border-spacing:0;}
.tg td{border-color:black;border-style:solid;border-width:1px;font-family:Arial, sans-serif;font-size:14px;
 overflow:hidden;padding:10px 5px;word-break:normal;}
.tg th{border-color:black;border-style:solid;border-width:1px;font-family:Arial, sans-serif;font-size:14px;
 font-weight:normal;overflow:hidden;padding:10px 5px;word-break:normal;}
.tg .tg-1wig{font-weight:bold;text-align:left;vertical-align:top}
.tg .tg-0lax{text-align:left;vertical-align:top}
</style>
<table class="tg"><thead>
 <tr>
 <th class="tg-0lax"></th>
 <th class="tg-1wig">Description</th>
 <th class="tg-1wig">API Line_Reports</th>
 <th class="tg-1wig">Example value</th>
 <th class="tg-1wig">API Bulk Disruptions</th>
 <th class="tg-1wig">Example value</th>
 </tr></thead>
<tbody>
 <tr>
 <td class="tg-0lax">1</td>
 <td class="tg-0lax">Type</td>
 <td class="tg-0lax">pt_objects.embedded_type</td>
 <td class="tg-0lax">[line; network; stop_point; stop_area]</td>
 <td class="tg-0lax">impactedObjects.type</td>
 <td class="tg-0lax">[line; network; stop_point; stop_area]</td>
 </tr>
 <tr>
 <td class="tg-0lax">2</td>
 <td class="tg-0lax">Identifier of impacted object</td>
 <td class="tg-0lax">pt_objects.[line; network; stop_point; stop_area].id</td>
 <td class="tg-0lax">line:IDFM:C01110</td>
 <td class="tg-0lax">impactedObjects.id</td>
 <td class="tg-0lax">line:IDFM:C01110</td>
 </tr>
 <tr>
 <td class="tg-0lax">3</td>
 <td class="tg-0lax">Name of impacted object</td>
 <td class="tg-0lax">pt_objects.[line; network; stop_point; stop_area].name</td>
 <td class="tg-0lax">75</td>
 <td class="tg-0lax">impactedObjects.name</td>
 <td class="tg-0lax">75</td>
 </tr>
 <tr>
 <td class="tg-0lax">4</td>
 <td class="tg-0lax">Link to traffic info</td>
 <td class="tg-0lax">pt_objects.[line; network; stop_point; stop_area].links.id</td>
 <td class="tg-0lax">35088aa0-abdd-11ee-97fc-0a58a9feac02</td>
 <td class="tg-0lax">impactedObjects.disruptionIds</td>
 <td class="tg-0lax">35088aa0-abdd-11ee-97fc-0a58a9feac02</td>
 </tr>
</tbody></table>

<h3 id="traffic-information">Traffic-information</h3>

<style type="text/css">
.tg {border-collapse:collapse;border-spacing:0;}
.tg td{border-color:black;border-style:solid;border-width:1px;font-family:Arial, sans-serif;font-size:14px;
 overflow:hidden;padding:10px 5px;word-break:normal;}
.tg th{border-color:black;border-style:solid;border-width:1px;font-family:Arial, sans-serif;font-size:14px;
 font-weight:normal;overflow:hidden;padding:10px 5px;word-break:normal;}
.tg .tg-1wig{font-weight:bold;text-align:left;vertical-align:top}
.tg .tg-0lax{text-align:left;vertical-align:top}
</style>
<table class="tg"><thead>
 <tr>
 <th class="tg-1wig"></th>
 <th class="tg-1wig">Description</th>
 <th class="tg-1wig">API Line_Reports</th>
 <th class="tg-1wig">Example Value</th>
 <th class="tg-1wig">API Bulk Disruptions</th>
 <th class="tg-1wig">Example Value</th>
 </tr></thead>
<tbody>
 <tr>
 <td class="tg-0lax">1</td>
 <td class="tg-0lax">Traffic info identifier</td>
 <td class="tg-0lax">id</td>
 <td class="tg-0lax">35088aa0-abdd-11ee-97fc-0a58a9feac02</td>
 <td class="tg-0lax">disruptions.id</td>
 <td class="tg-0lax">35088aa0-abdd-11ee-97fc-0a58a9feac02</td>
 </tr>
 <tr>
 <td class="tg-0lax">2</td>
 <td class="tg-0lax">Start of application period</td>
 <td class="tg-0lax">application_periods.begin</td>
 <td class="tg-0lax">20240102T051500</td>
 <td class="tg-0lax">disruptions.applicationPeriods.begin</td>
 <td class="tg-0lax">20240102T051500</td>
 </tr>
 <tr>
 <td class="tg-0lax">3</td>
 <td class="tg-0lax">End of application period</td>
 <td class="tg-0lax">application_periods.end</td>
 <td class="tg-0lax">20240512T024500</td>
 <td class="tg-0lax">disruptions.applicationPeriods.end</td>
 <td class="tg-0lax">20240512T024500</td>
 </tr>
 <tr>
 <td class="tg-0lax">4</td>
 <td class="tg-0lax">Update date</td>
 <td class="tg-0lax">updated_at</td>
 <td class="tg-0lax">20240105T161506</td>
 <td class="tg-0lax">disruptions.lastUpdate</td>
 <td class="tg-0lax">20240105T161506</td>
 </tr>
 <tr>
 <td class="tg-0lax">5</td>
 <td class="tg-0lax">Cause</td>
 <td class="tg-0lax">cause</td>
 <td class="tg-0lax">[work; disruption; information]</td>
 <td class="tg-0lax">disruptions.cause</td>
 <td class="tg-0lax">[WORK; DISRUPTION; INFORMATION]</td>
 </tr>
 <tr>
 <td class="tg-0lax">6</td>
 <td class="tg-0lax">Severity</td>
 <td class="tg-0lax">severity.name</td>
 <td class="tg-0lax">[blocking; disturbed; information]</td>
 <td class="tg-0lax">disruptions.severity</td>
 <td class="tg-0lax">[BLOCKING; DISTURBED; INFORMATION]</td>
 </tr>
 <tr>
 <td class="tg-0lax">7</td>
 <td class="tg-0lax">Label</td>
 <td class="tg-0lax">tags</td>
 <td class="tg-0lax">News</td>
 <td class="tg-0lax">disruptions.tags</td>
 <td class="tg-0lax">News</td>
 </tr>
 <tr>
 <td class="tg-0lax">8</td>
 <td class="tg-0lax">Title</td>
 <td class="tg-0lax">messages.text</td>
 <td class="tg-0lax">Bus 75 : Travaux - Stops not served</td>
 <td class="tg-0lax">disruptions.title</td>
 <td class="tg-0lax">Bus 75 : Travaux - Stops not served</d>
 </tr>
 <tr>
 <td class="tg-0lax">9</td>
 <td class="tg-0lax">Message</td>
 <td class="tg-0lax">messages.text</td>
 <td class="tg-0lax">Line 75 is diverted: stops between Alibert and République are no longer served in the direction of Panthéon. Estimated resumption: Sunday May 12, 2024, from 02:00. Reason: works. More information on ratp.fr</td>.
 <td class="tg-0lax">disruptions.message</td>
 <td class="tg-0lax">Line 75 is diverted: stops between Alibert and République are no longer served in the direction of Panthéon. Estimated resumption: Sunday, May 12, 2024, from 02:00. Reason: works. More information on ratp.fr</td>.
 </tr>
</tbody></table>

API Trafic messages - Global query

Media: For SNCF and the OPTILE Bus network,&nbsp;real-time APIs do not have the&nbsp;information that is provided on media (website, Twitter, ...).Station screens<ul><li>RATP : All traffic info&nbsp;available in RER and &nbsp;metro stations and on RATP media.</li><li>SNCF : Information available on&nbsp;screens arranged in stations.</li><li>Bus : Information available on&nbsp;screens located at bus Stops.</li></ul><h3 id="structure-des-requ%C3%AAtesparam%C3%A8tres-d%E2%80%99appel%E2%80%8B">Request structure - Call parameters</h3>Stop : This service provides traffic information displayed on screens in real time at a given stop. Example Gare de Saint-Rémy-Lès-Chevreuse : STIF:StopPoint:Q:412844:Ligne : This service provides traffic information displayed on the real-time screens of a given line.Example Ligne RER C : STIF:Line::C01727:The ALL call parameter provides traffic information displayed on the real-time screens of all lines in the network. Example: LineRef=ALLChannel: This service identifies the channel for which you wish to obtain the traffic information displayed on the screens in real time.&nbsp; If this field is not present, the request concerns all channels.Example: InfoChannelRef=Information OR Disruption OR CommercialAttention: To query the API you can either specify the "StopPointRef" or "LineRef" field, but not both at the same time.One of these two fields is required, as the "InfoChannelRef" field cannot be queried on its own.

API Messages displayed on screens

Traffic & Works information APIs

Getting to grips with APIs

A Reuses is an illustration of the use of a piece of data. The data available within the PRIM catalog are subject to user licenses, some of which oblige users to share their reuses in Open data. On the catalog, some data are subject to licenses that require sharing of reuses, you can consult<a href="http://prim.iledefrance-mobilites.fr/fr/licences" rel="noreferrer"> the section dedicated</a> to licenses on PRIM.To make it easier for PRIM portal users to comply with this obligation, the Reuses sharing path has been set up on the platform.&nbsp; In the PRIM data catalog, the number of available Reuses for each API, dataset or widget is indicated on the data cells. If no Reuses have been shared for a dataset, nothing is indicated.

What is a reuse?

<h3 id="acc%C3%A9der-aux-r%C3%A9utilisations%E2%80%8B">Accessing Reuses</h3>Consulting and sharing Reuses is accessible in three places on the PRIM site: <ol><li>From the "&nbsp;Reuses&nbsp;" page accessible via the "&nbsp;Data&nbsp;" menu of the PRIM platform. Once you've opened the "&nbsp;Reuses&nbsp;" page, you'll need to open the "&nbsp;Reuses&nbsp;" tab. </li><li>From the "&nbsp;Contribute&nbsp;" page of the PRIM platform.</li><li>From the individual data detail pages available in the "&nbsp;Data catalog&nbsp;". Once you've opened the detailed page, you'll need to open the Reuses tab.</li></ol><h3 id="share-r%C3%A9reuses%E2%80%8B">Share Reuses</h3>To share a new data reuse, simply click on the "&nbsp;submit a reuse&nbsp;" button, then complete the Reuses sharing request form. Once the form has been completed and submitted, it will be processed by our teams, who will then validate it. Processing time is approximately two weeks. When your request to share a data reuse is validated, you receive an email and the reuse is automatically published on PRIM.<h3 id="refusal-d%E2%80%99a-request-to-share-r%C3%A9use">Refusal of a request to share a reuse</h3>It may happen that a request to share reuses is refused. When your request to share a data reuse is refused, you will receive an email in which the reason for refusal is systematically indicated and the reuse is not published on PRIM.

Publish a reuse

<h2 id="modification-d%E2%80%99une-r%C3%A9utilisation">Modification of a Reuses</h2>For one reason or another, Reuses may be modified by our teams before or after they are published on PRIM.The elements that may be modified are, for example, the title or description of a Reuses. Depending on the degree of importance of the modification made, you will be notified or not, by e-mail of the modification made to your Reuses share.It is not possible to modify personal information such as name, e-mail or website of a Reuses already published or awaiting validation. You will need to submit a new request to share Reuses if you wish to make changes to these elements.<h2 id="delete-d%E2%80%99une-r%C3%A9use">Deleting a Reuse</h2>Following a request from you, or for one reason or another, a Reuses may be deleted by our teams. When your data reuse is deleted, you will receive an e-mail in which the reason for deletion is systematically indicated and the reuse is removed from PRIM.