WEB API

for fleet owner

Quickstart - Examples

Info: Stellantis Fleet Owner API for ex Groupe PSA brands (Citroën, DS, Peugeot, Opel and Vauxhall) is made for organisations owning fleet of vehicles.

This page is a list of examples of HTTP requests to Stellantis Fleet Owners API for ex Groupe PSA brands (Citroën, DS, Peugeot, Opel and Vauxhall).

These examples will show you how to deal with:

  • Single objects
  • Collections objects
  • GeoJSON
  • Post and Delete verbs HTTP verbs

Get Account Info #

Web API base endpoint /fleets allows to retrieve information about this account Fleet(s) of vehicles..

This endpoint returns a single object.

1
2
3
4
5
6
7
8
$ curl \
  --GET \
  --url 'https://api-cert.groupe-psa.com/connectedcar/v3/fleets' \
  --data 'client_id=<client_id>' \
  --header 'Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==' \
  --cert 'path/to/client_cert.pem[:<cert_password>]' \
  --key 'path/to/key.pem' \
  --cacert 'path/to/ca_cert.pem' \

Get a List of Vehicles #

The /fleets/{fid}/vehicles endpoint allow you to retrieve a list of your vehicles.

This endpoint returns a collection, check-out pagination for more information about indexRange and pageSize.

1
2
3
4
5
6
7
8
9
10
$ curl \
  --GET \
  --url 'https://api-cert.groupe-psa.com/connectedcar/v3/fleets/{fid}/vehicles' \
  --data 'client_id=<client_id>' \
  --header 'Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==' \
  --cert 'path/to/client_cert.pem[:<cert_password>]' \
  --key 'path/to/key.pem' \
  --cacert 'path/to/ca_cert.pem' \
  --data 'indexRange=<element_per_page>' \
  --data 'pageSize=<nb_of_pages>' \

Get a Vehicle Position #

The /fleets/{fid}/vehicles/{id}/lastPosition endpoint allows to retrieve the last known position of a vehicle.

LastPosition endpoints returns application/vnd.geo+json, check-out HTTP Body format .

1
2
3
4
5
6
7
8
$ curl \
  --GET \
  --url 'https://api-cert.groupe-psa.com/connectedcar/v3/fleets/{fid}/vehicles/{id}/lastPosition' \
  --data 'client_id=<client_id>' \
  --header 'Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==' \
  --cert 'path/to/client_cert.pem[:<cert_password>]' \
  --key 'path/to/key.pem' \
  --cacert 'path/to/ca_cert.pem' \

Get Alerts of a Vehicle #

The /fleets/{fid}/vehicles/{id}/alerts endpoint allows to retrieve a list of alerts for a vehicle.

  • Path parameter {id} is the unique identifier of a vehicle.
  • Query parameter locale will change the language of the alert message.
1
2
3
4
5
6
7
8
9
10
11
$ curl \
  --GET \
  --url 'https://api-cert.groupe-psa.com/connectedcar/v3/fleets/{fid}/vehicles/{id}/alerts' \
  --data 'client_id=<client_id>' \
  --header 'Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==' \
  --cert 'path/to/client_cert.pem[:<cert_password>]' \
  --key 'path/to/key.pem' \
  --cacert 'path/to/ca_cert.pem' \
  --data 'indexRange=<element_per_page>' \
  --data 'pageSize=<nb_of_pages>' \
  --data 'locale=<language>' \

Post New Monitor #

The /fleets/{fid}/monitors endpoint allow you to create a new monitor.

Check-out the dedicated tutorial for information about Monitors

1
2
3
4
5
6
7
8
9
$ curl \
  --POST \
  --url 'https://api-cert.groupe-psa.com/connectedcar/v3/fleets/{fid}/monitors' \
  --data 'client_id=<client_id>' \
  --header 'Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==' \
  --cert 'path/to/client_cert.pem[:<cert_password>]' \
  --key 'path/to/key.pem' \
  --cacert 'path/to/ca_cert.pem' \
  --data '<check out HTTP body>' \
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
{
   "label":"IDF Zone monitor With Data Triggering:[vehicle.energy.electric.level] OR on Mondays",
   "subscribeParam":{
      "refreshEvent":600,
      "retryPolicy":{
         "policy":"Always",
         "maxRetryNumber":3,
         "retryDelay":120
      },
      "batchNotify":{
         "size":10,
         "timeWindow":300
      },
      "callback":{
         "target":"http://my.dn/monitors/cb1",
         "name":"HTTP_CB",
         "attributes":[
            {
               "type":"Query",
               "key":"vin",
               "value":"$vin"
            },
            {
               "type":"Header",
               "key":"Authorization",
               "value":"Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ=="
            }
         ]
      }
   },
   "extendedEventParam":[
      "vehicle.alerts",
      "vehicle.status"
   ],
   "triggerParam":{
      "triggers": [
      {
         "name": "outOfParis",
         "zone": {
            "transition": "Out",
            "circle": {
               "radius": 20,
               "center": {
               "longitude": 2.333333,
               "latitude": 48.866667
               }
            }
         },
         "name": "onMonday",
         "time": {
            "times": [
               {
               "recurrence": "Daily",
               "start": "PT14H30M",
               "occurence": {
                  "day": [
                     "Mon"
                  ]
               },
               "duration": "PT04H30M"
             }
            ],
            "time.zone": "Europe/Paris"
         },
         "name": "batteryIsLow",
         "data": {
          "data": "vehicle.energy.electric.level",
          "op": "lowerThan",
          "value": [
            "50"
            ]
        }
      }
    ],
    "bool.exp": "((outOfParis & (batteryIsLow | onMonday)"
  }
}

Delete a Monitor #

The /fleets/{fid}/monitors/{mid} endpoint allow you to retrieve a list of alerts for a vehicle.

Check-out the dedicated tutorial for information about Monitors

1
2
3
4
5
6
7
8
$ curl \
  --DELETE \
  --url 'https://api-cert.groupe-psa.com/connectedcar/v3/fleets/{fid}/monitors/{mid}' \
  --data 'client_id=<client_id>' \
  --header 'Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==' \
  --cert 'path/to/client_cert.pem[:<cert_password>]' \
  --key 'path/to/key.pem' \
  --cacert 'path/to/ca_cert.pem' \

See Also

Check out this Fleet Owner API list of References to discover Stellantis Connected Vehicles features.