API State
Detailed description
The API Calculator Ile-de-France Mobilités - Trafic messages (Navitia) gives all information concerning traffic disruptions (incidents, planned and unplanned works...).
This service is based on Navitia technology and returns results in the form of JSON objects.
Accessing the API
You must be logged in to your user account to access the API.
The quota limitations for this API are as follows:
.User group | Number of requests per second | Number of requests
per day |
Old user (API tokens generated before March 13, 2024) | 5 | |
New user (API token generated between March 13 and September 2024) | 5 | 4,000 |
Manage my quotas
To track your API consumption and increase your quotas, go to My API consumption.
General documentation
General documentation provides a better understanding of the API and its precautions for use.
To consult these documents in English, please visit the Help page ?
Technical documentation
A technical documentation provides more detailed information on the functions and possible settings of the API.
Pagination
The results of the API Calculator Ile-de-France Mobilités - Trafic messages (Navitia)are paginated to avoid causing query assistants to fall into error.
Each Navitia response contains a pagination object:
Key | Type | Description |
items_per_page | int | Number of elements
per page |
items_on_page | int | Number of elements
on page |
start_page | int | Page number
page number |
total_result | int | Total number of elements
of elements for this query |
You can set the number of elements obtained in a response using 2 parameters:
Parameter | Type | Description |
start_page | int | Page number
page |
count | int | Number of elements
per page |
The number of elements returned for a query can't be more than 100. If you ask for more, the API will return the first 100 results, and you'll have to page using the start_page parameter to get the next 100.
We recommend adding the available parameters to your queries to get more precise answers that fit your needs.
If, however, you wish to obtain the entire network traffic information in a single query, a new API Traffic messages - global query is available on PRIM.
General API conditions of use and data license
Use of the Île-de-France Mobilités API is subject to General Conditions of Use Data from the Île-de-France Mobilités API are subject to the Mobility License.