Renault endpoints

This is a list of the endpoints available, and their characteristics.

Vehicle data endpoints

battery-status

Base url:

/commerce/v1/accounts/{account_id}/kamereon/kca/car-adapter/v2/cars/{vin}/battery-status

Sample return:
{
  "data": {
    "type": "Car",
    "id": "VF1AAAAA555777999",
    "attributes": {
      "timestamp": "2020-01-12T21:40:16Z",
      "batteryLevel": 60,
      "batteryTemperature": 20,
      "batteryAutonomy": 141,
      "batteryCapacity": 0,
      "batteryAvailableEnergy": 31,
      "plugStatus": 1,
      "chargingStatus": 1.0,
      "chargingRemainingTime": 145,
      "chargingInstantaneousPower": 27.0
    }
  }
}

Note

  • batteryTemperature is not always present.

  • batteryCapacity appears to always return 0.

On Zoe40 (model code X101VE):
  • chargingInstantaneousPower gives value in watts.

  • chargingStatus uses only a subset of ChargeStatus enum (NOT_IN_CHARGE = 0.0, CHARGE_IN_PROGRESS = 1.0, CHARGE_ERROR = -1.0)

On Zoe50 (model code X102VE):
  • batteryTemperature appears completely wrong.

  • chargingInstantaneousPower seems to return values in kilowatts, but the values still appear completely wrong.

charge-history

Base url:

/commerce/v1/accounts/{account_id}/kamereon/kca/car-adapter/v1/cars/{vin}/charge-history

Sample return:
{
  "data": {
    "type": "Car",
    "id": "VF1AAAAA555777999",
    "attributes": {
      "chargeSummaries": [
        {
          "day": "20201208",
          "totalChargesNumber": 2,
          "totalChargesDuration": 495,
          "totalChargesErrors": 0
        },
        {
          "day": "20201205",
          "totalChargesNumber": 1,
          "totalChargesDuration": 657,
          "totalChargesErrors": 0
        }
      ]
    }
  }
}

charge-mode

Base url:

/commerce/v1/accounts/{account_id}/kamereon/kca/car-adapter/v1/cars/{vin}/charge-mode

Sample return:
{
  "data": {
    "type": "Car",
    "id": "VF1AAAAA555777999",
    "attributes": { "chargeMode": "always" }
  }
}

charges

Base url:

/commerce/v1/accounts/{account_id}/kamereon/kca/car-adapter/v1/cars/{vin}/charges

Sample return:
{
  "data": {
    "type": "Car",
    "id": "VF1AAAAA555777999",
    "attributes": {
      "charges": [
        {
          "chargeStartDate": "2020-11-11T00:31:03Z",
          "chargeEndDate": "2020-11-11T08:30:17Z",
          "chargeDuration": 479,
          "chargeStartBatteryLevel": 15,
          "chargeEndBatteryLevel": 74,
          "chargeBatteryLevelRecovered": 59,
          "chargePower": "slow",
          "chargeStartInstantaneousPower": 3100,
          "chargeEndStatus": "ok"
        }
      ]
    }
  }
}

charging-settings

Base url:

/commerce/v1/accounts/{account_id}/kamereon/kca/car-adapter/v1/cars/{vin}/charging-settings

Sample return:
{
  "data": {
    "type": "Car",
    "id": "VF1AAAAA555777999",
    "attributes": {
      "mode": "scheduled",
      "schedules": [
        {
          "id": 1,
          "activated": true,
          "monday": {
            "startTime": "T12:00Z",
            "duration": 15
          },
          "tuesday": {
            "startTime": "T04:30Z",
            "duration": 420
          },
          "wednesday": {
            "startTime": "T22:30Z",
            "duration": 420
          },
          "thursday": {
            "startTime": "T22:00Z",
            "duration": 420
          },
          "friday": {
            "startTime": "T12:15Z",
            "duration": 15
          },
          "saturday": {
            "startTime": "T12:30Z",
            "duration": 30
          },
          "sunday": {
            "startTime": "T12:45Z",
            "duration": 45
          }
        }
      ]
    }
  }
}
{
  "data": {
    "type": "Car",
    "id": "VF1AAAAA555777999",
    "attributes": {
      "mode": "scheduled",
      "schedules": [
        {
          "id": 1,
          "activated": true,
          "monday": {
            "startTime": "T00:00Z",
            "duration": 450
          },
          "tuesday": {
            "startTime": "T00:00Z",
            "duration": 450
          },
          "wednesday": {
            "startTime": "T00:00Z",
            "duration": 450
          },
          "thursday": {
            "startTime": "T00:00Z",
            "duration": 450
          },
          "friday": {
            "startTime": "T00:00Z",
            "duration": 450
          },
          "saturday": {
            "startTime": "T00:00Z",
            "duration": 450
          },
          "sunday": {
            "startTime": "T00:00Z",
            "duration": 450
          }
        },
        {
          "id": 2,
          "activated": true,
          "monday": {
            "startTime": "T23:30Z",
            "duration": 15
          },
          "tuesday": {
            "startTime": "T23:30Z",
            "duration": 15
          },
          "wednesday": {
            "startTime": "T23:30Z",
            "duration": 15
          },
          "thursday": {
            "startTime": "T23:30Z",
            "duration": 15
          },
          "friday": {
            "startTime": "T23:30Z",
            "duration": 15
          },
          "saturday": {
            "startTime": "T23:30Z",
            "duration": 15
          },
          "sunday": {
            "startTime": "T23:30Z",
            "duration": 15
          }
        },
        {
          "id": 3,
          "activated": false
        },
        {
          "id": 4,
          "activated": false
        },
        {
          "id": 5,
          "activated": false
        }
      ]
    }
  }
}

cockpit

Base url:

/commerce/v1/accounts/{account_id}/kamereon/kca/car-adapter/v2/cars/{vin}/cockpit

Sample return:
{
  "data": {
    "type": "Car",
    "id": "VF1AAAAA555777999",
    "attributes": { "totalMileage": 49114.27 }
  }
}

hvac-history

Base url:

/commerce/v1/accounts/{account_id}/kamereon/kca/car-adapter/v1/cars/{vin}/hvac-history

Sample return:

Sample data is not yet available for this endpoint.

Please check the Contributor Guide to can provide a sample.

hvac-sessions

Base url:

/commerce/v1/accounts/{account_id}/kamereon/kca/car-adapter/v1/cars/{vin}/hvac-sessions

Sample return:

Sample data is not yet available for this endpoint.

Please check the Contributor Guide to can provide a sample.

hvac-status

Base url:

/commerce/v1/accounts/{account_id}/kamereon/kca/car-adapter/v1/cars/{vin}/hvac-status

Samples return:
{
  "data": {
    "type": "Car",
    "id": "VF1AAAAA555777999",
    "attributes": { "externalTemperature": 8.0, "hvacStatus": "off" }
  }
}
{
  "data": {
    "type": "Car",
    "id": "UU1AAAAA555777123",
    "attributes": {
      "socThreshold": 30.0,
      "hvacStatus": "off",
      "lastUpdateTime": "2020-12-03T00:00:00Z"
    }
  }
}

Note

On Zoe40 (model code X101VE):

hvacStatus seems to always report off, even when preconditioning is in progress.

On Zoe50 (model code X102VE):

This endpoint seem to be unavailable and returns an error 'err.func.403': 'Operation not supported Operation not supported for this can (C1A)'.

hvac-settings

Base url:

/commerce/v1/accounts/{account_id}/kamereon/kca/car-adapter/v1/cars/{vin}/hvac-settings

Sample return:
{
  "data": {
    "type": "Car",
    "id": "VF1AAAAA555777999",
    "attributes": {
      "dateTime": "2020-12-24T20:00:00.000Z",
      "mode": "scheduled",
      "schedules": [
        {
          "id": 1,
          "activated": false
        },
        {
          "id": 2,
          "activated": true,
          "wednesday": { "readyAtTime": "T15:15Z" },
          "friday": { "readyAtTime": "T15:15Z" }
        },
        {
          "id": 3,
          "activated": false
        },
        {
          "id": 4,
          "activated": false
        },
        {
          "id": 5,
          "activated": false
        }
      ]
    }
  }
}

location

Base url:

/commerce/v1/accounts/{account_id}/kamereon/kca/car-adapter/v1/cars/{vin}/location

Samples return:
{
  "data": {
    "type": "Car",
    "id": "VF1AAAAA555777999",
    "attributes": {
      "gpsLatitude": 48.1234567,
      "gpsLongitude": 11.1234567,
      "lastUpdateTime": "2020-02-18T16:58:38Z"
    }
  }
}
{
  "data": {
    "type": "Car",
    "id": "VF1AAAAA555777999",
    "attributes": {
      "gpsDirection": null,
      "gpsLatitude": 48.1234567,
      "gpsLongitude": 11.1234567,
      "lastUpdateTime": "2020-02-18T16:58:38Z"
    }
  }
}

lock-status

Base url:

/commerce/v1/accounts/{account_id}/kamereon/kca/car-adapter/v1/cars/{vin}/lock-status

Sample return:

Sample data is not yet available for this endpoint.

Please check the Contributor Guide to can provide a sample.

notification-settings

Base url:

/commerce/v1/accounts/{account_id}/kamereon/kca/car-adapter/v1/cars/{vin}/notification-settings

Sample return:

Sample data is not yet available for this endpoint.

Please check the Contributor Guide to can provide a sample.

Action endpoints

actions/charge-mode

Base url:

/commerce/v1/accounts/{account_id}/kamereon/kca/car-adapter/v1/cars/{vin}/actions/charge-mode

Sample payload:

Sample payload is not yet available for this endpoint.

Please check the Contributor Guide to can provide a sample.

actions/charge-schedule

Base url:

/commerce/v1/accounts/{account_id}/kamereon/kca/car-adapter/v2/cars/{vin}/actions/charge-schedule

Sample payload:

Sample payload is not yet available for this endpoint.

Please check the Contributor Guide to can provide a sample.

actions/charging-start

Base url:

/commerce/v1/accounts/{account_id}/kamereon/kca/car-adapter/v1/cars/{vin}/actions/charging-start

Sample payload:

Sample payload is not yet available for this endpoint.

Please check the Contributor Guide to can provide a sample.

actions/hvac-start

Base url:

/commerce/v1/accounts/{account_id}/kamereon/kca/car-adapter/v1/cars/{vin}/actions/hvac-start

Sample payload:

Sample payload is not yet available for this endpoint.

Please check the Contributor Guide to can provide a sample.

Note

On Zoe50 (model code X102VE):

Payload {'action': 'cancel'} to stop HVAC does not create errors but has no effect on the vehicle (Renault side limitation).

actions/hvac-schedule

Base url:

/commerce/v1/accounts/{account_id}/kamereon/kca/car-adapter/v2/cars/{vin}/actions/hvac-schedule

Sample payload:

Sample payload is not yet available for this endpoint.

Please check the Contributor Guide to can provide a sample.