WEB API

for fleet owner

Presentation

    Note: Groupe PSA's B2B APIs are made exclusively for our business partners owning fleet of vehicles. If you are looking for private car's API please look at this!

    PSA GROUPE’s B2B WEB API #

    Our REST APIs implements various endpoints to retrieve resources from your Groupe PSA’s vehicles. Under certain circumstances you will also be able to remote control some features of your vehicles, like opening the doors or turning AC on! Groupe PSA’s APIs are based on open standards: OpenAPIv3, JSON, GeoJson & HAL. Using this You will be able to access a lot of your vehicle data like geolocation, fuel consumption, mileage before maintenance or even remaining time of charge.

    HOW DOES IT WORK? #

    Vehicles are using various sensors which aim to improve security and driving experience. Those sensors are available for embedded applications development for the inboard car computer, as you can see in this section of this documentation website.

    Our web APIs grants you access to this data even outside the car:

    presentationUnified

    Sensors are collecting data inside the vehicle and send them to Groupe PSA via mobile network. Our servers will then process these raw data into unified and understandable info. Furthermore, cloud storage allow you to access your data at any time even though the vehicle is turned-off.

    Everything is processed on our side (Groupe PSA) in order to provide you (Partner) the same standard data, whatever the type of vehicles (brand new or older, regular fuel or electric consumption).

    FEATURES #

    By requesting this api you will have access to various features:

    Features

    History: trips, telemetrics, notifications and collisions are useful data, maybe you will need to retrieve it, that’s why we choose to store those data and allow you to access history.
    Feature Description
    General info Get a user or car general info, like brand, model, fuel type.
    Maintenance Stay tuned on car maintenance, time and mileage before maintenance.
    Collision Be notified of collisions and where it happened.
    Trips Browse into cars trips, departure point, arrival.
    Alerts Get history of in-car alerts (oil, engine, breaks etc).
    Telemetrics Retrieve and track vehicles telemetrics (speed*, location, fuel level, blinking lights etc).
    Monitor Configure car monitoring like notification for car leaving defined area. Click here to learn more about monitors.
    Status Retrieve car status like last position, autonomy, open doors.

    *speed: according to country’s legislation.

    BROWSING AND ALERTS #

    Our API allow you two ways to access vehicles data. You can either browse history or monitor data and receive alerts.

    • Request & Browse: this the way APIs usually operates. Request/response system allow you to retrieve various data of your fleet vehicles (example: model, fuel consumption history).

    • Monitoring: create your own dedicated monitors using our APIs. You will get notified every time a parameter changed as you specified (example: vehicle leaving a defined area). Find out more about how to use and configure monitors on this page.

    STANDARDS #

    We think that accessing easily and efficiently to vehicle’s data is important, that’s why we choose to design our APIs with up-to-date open standards.

    Groupe PSA’s web APIs are based on REST principles, data resources are accessed via standard HTTPS requests in UTF-8 format. We use OpenAPI v3 for specification, JSON in order to exchange data between you and your cars and HAL for naviguation.

    Also, we use standards for formating: GeoJson for geolocation data and RFC3339 for time format.

    Click here and find a preview!

    DATA REFRESHMENT #

    Sensors are gathering all types of interesting data inside cars. First, these data are collected in a dedicated embedded hardware in the vehicle. Then data are sent to Groupe PSA’s cloud via mobile network:

    • Regular refreshment: data are refreshed on a regular basis depending on sensor class and vehicle manufacturing date.
    • Event refreshment: internal events happening in the vehicle could lead to a refreshment of some data, for example turn on the car.

    Refreshment rates improves with vehicles bought since 2019.

    presentationFrequency

    SEE ALSO #

    PREVIEW

    Want to see what it’s look like ? Browse our Preview.

    TRY OUT!

    Retrieve all reference of this API, go to the API List.