Data recommendations
API State
Detailed Description
The "Generation of line indices" API is the official tool for retrieving the visuals of the lines of the Île-de-France Mobilités network. It is based on regional signage requirements for all modes of transport: Metro, RER, Train, Tramway, Bus and Cable.
API entry points
The Icons API provides two endpoints to retrieve transport graphics resources as needed:
1. getIcon – Retrieve a unique icon
GET /icons/:lineId
Retrieves the SVG icon for a specific transport line. This endpoint is optimized for use cases where you need only one icon at a time.
Settings:
lineId(required): Line IDusage(optional): Type of use (default: 'default')
Answer: Compressed SVG icon
2. getSprite - Retrieve a set of icons
GET /icons/sprite
Generates a sprite or ZIP archive containing multiple line icons. This endpoint is ideal for efficiently loading a set of icons in a single request, especially for applications displaying multiple rows simultaneously.
Settings:
lineIds(optional): Comma-separated list of identifiersgetAll: Retrieve all available iconsdisplay: Flip icon as image (true/false)transportMode(optional): Filter by mode of transportformat(optional): Output format (sprite or zip_svg)usage(optional): Type of uselastUpdate(optional): Check out only updates from a date
Answer: SVG sprite or ZIP archive (compressed)
Access to the API
You must be logged in to your user account to access the API.
General documentation
General documentation allows you to better understand the API and to know the precautions for its use.
Technical documentation
Documentation provides more detailed information on the possible functions and settings of the API.
API Terms of Use and Data License
The use of the Île-de-France Mobilités API is subject to General Terms and Conditions of Use The data from the Île-de-France Mobilités API is subject to the Mobility License.