GetVehicleState
Overview
The GetVehicleState query returns typed JSON vehicle state (doors, SOC, climate, OTA, etc.).
The app also streams much of this data through Parallax ParallaxMessages as base64 protobuf when vehicle feature PARALLAX_VEHICLE_STATE is enabled, and still opens the legacy WebSocket vehicleState subscription on the same WebSocket URL. Use this HTTP query for one-shot reads or when building against the JSON schema.
POST https://rivian.com/api/gql/gateway/graphql
Required Headers
a-sess: <your app session token>
u-sess: <your user session token>
csrf-token: <your CSRF token>
Request Body
{
"operationName": "GetVehicleState",
"variables": {
"vehicleID": <your-vehicle-id>
},
"query": "query GetVehicleState($vehicleID: String!) { vehicleState(id: $vehicleID) { __typename gnssLocation { __typename latitude longitude timeStamp } alarmSoundStatus { __typename timeStamp value } timeToEndOfCharge { __typename timeStamp value } doorFrontLeftLocked { __typename timeStamp value } doorFrontLeftClosed { __typename timeStamp value } doorFrontRightLocked { __typename timeStamp value } doorFrontRightClosed { __typename timeStamp value } doorRearLeftLocked { __typename timeStamp value } doorRearLeftClosed { __typename timeStamp value } doorRearRightLocked { __typename timeStamp value } doorRearRightClosed { __typename timeStamp value } windowFrontLeftClosed { __typename timeStamp value } windowFrontRightClosed { __typename timeStamp value } windowFrontLeftCalibrated { __typename timeStamp value } windowFrontRightCalibrated { __typename timeStamp value } windowRearLeftCalibrated { __typename timeStamp value } windowRearRightCalibrated { __typename timeStamp value } closureFrunkLocked { __typename timeStamp value } closureFrunkClosed { __typename timeStamp value } gearGuardLocked { __typename timeStamp value } closureLiftgateLocked { __typename timeStamp value } closureLiftgateClosed { __typename timeStamp value } windowRearLeftClosed { __typename timeStamp value } windowRearRightClosed { __typename timeStamp value } closureSideBinLeftLocked { __typename timeStamp value } closureSideBinLeftClosed { __typename timeStamp value } closureSideBinRightLocked { __typename timeStamp value } closureSideBinRightClosed { __typename timeStamp value } closureTailgateLocked { __typename timeStamp value } closureTailgateClosed { __typename timeStamp value } closureTonneauLocked { __typename timeStamp value } closureTonneauClosed { __typename timeStamp value } wiperFluidState { __typename timeStamp value } powerState { __typename timeStamp value } batteryHvThermalEventPropagation { __typename timeStamp value } vehicleMileage { __typename timeStamp value } brakeFluidLow { __typename timeStamp value } gearStatus { __typename timeStamp value } tirePressureStatusFrontLeft { __typename timeStamp value } tirePressureStatusValidFrontLeft { __typename timeStamp value } tirePressureStatusFrontRight { __typename timeStamp value } tirePressureStatusValidFrontRight { __typename timeStamp value } tirePressureStatusRearLeft { __typename timeStamp value } tirePressureStatusValidRearLeft { __typename timeStamp value } tirePressureStatusRearRight { __typename timeStamp value } tirePressureStatusValidRearRight { __typename timeStamp value } batteryLevel { __typename timeStamp value } chargerState { __typename timeStamp value } batteryLimit { __typename timeStamp value } remoteChargingAvailable { __typename timeStamp value } batteryHvThermalEvent { __typename timeStamp value } rangeThreshold { __typename timeStamp value } distanceToEmpty { __typename timeStamp value } otaAvailableVersionNumber { __typename timeStamp value } otaAvailableVersionWeek { __typename timeStamp value } otaAvailableVersionYear { __typename timeStamp value } otaCurrentVersionNumber { __typename timeStamp value } otaCurrentVersionWeek { __typename timeStamp value } otaCurrentVersionYear { __typename timeStamp value } otaDownloadProgress { __typename timeStamp value } otaInstallDuration { __typename timeStamp value } otaInstallProgress { __typename timeStamp value } otaInstallReady { __typename timeStamp value } otaInstallTime { __typename timeStamp value } otaInstallType { __typename timeStamp value } otaStatus { __typename timeStamp value } otaCurrentStatus { __typename timeStamp value } cabinClimateInteriorTemperature { __typename timeStamp value } cabinPreconditioningStatus { __typename timeStamp value } cabinPreconditioningType { __typename timeStamp value } petModeStatus { __typename timeStamp value } petModeTemperatureStatus { __typename timeStamp value } cabinClimateDriverTemperature { __typename timeStamp value } gearGuardVideoStatus { __typename timeStamp value } gearGuardVideoMode { __typename timeStamp value } gearGuardVideoTermsAccepted { __typename timeStamp value } defrostDefogStatus { __typename timeStamp value } steeringWheelHeat { __typename timeStamp value } seatFrontLeftHeat { __typename timeStamp value } seatFrontRightHeat { __typename timeStamp value } seatRearLeftHeat { __typename timeStamp value } seatRearRightHeat { __typename timeStamp value } chargerStatus { __typename timeStamp value } seatFrontLeftVent { __typename timeStamp value } seatFrontRightVent { __typename timeStamp value } chargerDerateStatus { __typename timeStamp value } driveMode { __typename timeStamp value } } }"
}
Example Response
{
"data": {
"vehicleState": {
"__typename": "VehicleState",
"gnssLocation": {
"latitude": <your-lat>,
"longitude": <your-lng>,
"timeStamp": "2023-01-15T12:00:00.000Z",
"isAuthorized": true
},
"alarmSoundStatus": {
"timeStamp": "2023-01-15T12:05:00.000Z",
"value": "false"
},
"timeToEndOfCharge": {
"timeStamp": "2023-01-10T08:00:00.000Z",
"value": 0
},
"doorFrontLeftLocked": {
"timeStamp": "2023-01-15T12:00:00.000Z",
"value": "locked"
},
"doorFrontLeftClosed": {
"timeStamp": "2023-01-15T12:00:00.000Z",
"value": "closed"
},
"doorFrontRightLocked": {
"timeStamp": "2023-01-15T12:00:00.000Z",
"value": "locked"
},
"doorFrontRightClosed": {
"timeStamp": "2023-01-15T12:00:00.000Z",
"value": "closed"
},
"doorRearLeftLocked": {
"timeStamp": "2023-01-15T12:00:00.000Z",
"value": "locked"
},
"doorRearLeftClosed": {
"timeStamp": "2023-01-15T12:00:00.000Z",
"value": "closed"
},
"doorRearRightLocked": {
"timeStamp": "2023-01-15T12:00:00.000Z",
"value": "locked"
},
"doorRearRightClosed": {
"timeStamp": "2023-01-15T12:00:00.000Z",
"value": "closed"
},
"windowFrontLeftClosed": {
"timeStamp": "2023-01-15T12:00:00.000Z",
"value": "closed"
},
"windowFrontRightClosed": {
"timeStamp": "2023-01-15T12:00:00.000Z",
"value": "closed"
},
"windowFrontLeftCalibrated": {
"timeStamp": "2023-01-15T12:00:00.000Z",
"value": "Calibrated"
},
"windowFrontRightCalibrated": {
"timeStamp": "2023-01-15T12:00:00.000Z",
"value": "Calibrated"
},
"windowRearLeftCalibrated": {
"timeStamp": "2023-01-15T12:00:00.000Z",
"value": "Calibrated"
},
"windowRearRightCalibrated": {
"timeStamp": "2023-01-15T12:00:00.000Z",
"value": "Calibrated"
},
"closureFrunkLocked": {
"timeStamp": "2023-01-15T12:00:00.000Z",
"value": "locked"
},
"closureFrunkClosed": {
"timeStamp": "2023-01-15T12:00:00.000Z",
"value": "closed"
},
"closureFrunkNextAction": {
"timeStamp": "2023-01-15T12:05:00.000Z",
"value": "Open_Allowed"
},
"gearGuardLocked": {
"timeStamp": "2023-01-15T12:00:00.000Z",
"value": "unlocked"
},
"closureLiftgateLocked": {
"timeStamp": "2023-01-15T12:00:00.000Z",
"value": "locked"
},
"closureLiftgateClosed": {
"timeStamp": "2023-01-15T12:00:00.000Z",
"value": "signal_not_available"
},
"closureLiftgateNextAction": {
"timeStamp": "2023-01-15T12:05:00.000Z",
"value": "SNA"
},
"windowRearLeftClosed": {
"timeStamp": "2023-01-15T12:00:00.000Z",
"value": "closed"
},
"windowRearRightClosed": {
"timeStamp": "2023-01-15T12:00:00.000Z",
"value": "closed"
},
"closureSideBinLeftLocked": {
"timeStamp": "2023-01-15T12:00:00.000Z",
"value": "locked"
},
"closureSideBinLeftClosed": {
"timeStamp": "2023-01-15T12:00:00.000Z",
"value": "closed"
},
"closureSideBinRightLocked": {
"timeStamp": "2023-01-15T12:00:00.000Z",
"value": "locked"
},
"closureSideBinRightClosed": {
"timeStamp": "2023-01-15T12:00:00.000Z",
"value": "closed"
},
"closureSideBinLeftNextAction": {
"timeStamp": "2023-01-15T12:05:00.000Z",
"value": "SNA"
},
"closureSideBinRightNextAction": {
"timeStamp": "2023-01-15T12:05:00.000Z",
"value": "SNA"
},
"closureTailgateLocked": {
"timeStamp": "2023-01-15T12:00:00.000Z",
"value": "locked"
},
"closureTailgateClosed": {
"timeStamp": "2023-01-15T12:00:00.000Z",
"value": "closed"
},
"closureTailgateNextAction": {
"timeStamp": "2023-01-15T12:05:00.000Z",
"value": "SNA"
},
"closureTonneauLocked": {
"timeStamp": "2023-01-15T12:00:00.000Z",
"value": "locked"
},
"closureTonneauClosed": {
"timeStamp": "2023-01-15T12:00:00.000Z",
"value": "reserved"
},
"wiperFluidState": {
"timeStamp": "2023-01-10T08:00:00.000Z",
"value": "normal"
},
"powerState": {
"timeStamp": "2023-01-15T12:00:00.000Z",
"value": "sleep"
},
"batteryHvThermalEventPropagation": {
"timeStamp": "2023-01-15T12:05:00.000Z",
"value": "nominal"
},
"vehicleMileage": {
"timeStamp": "2023-01-10T08:00:00.000Z",
"value": 14517537
},
"brakeFluidLow": null,
"gearStatus": {
"timeStamp": "2023-01-15T12:00:00.000Z",
"value": "park"
},
"tirePressureStatusFrontLeft": {
"timeStamp": "2023-01-15T12:05:00.000Z",
"value": "OK"
},
"tirePressureStatusValidFrontLeft": {
"timeStamp": "2023-01-15T12:05:00.000Z",
"value": "invalid"
},
"tirePressureStatusFrontRight": {
"timeStamp": "2023-01-15T12:05:00.000Z",
"value": "OK"
},
"tirePressureStatusValidFrontRight": {
"timeStamp": "2023-01-15T12:05:00.000Z",
"value": "invalid"
},
"tirePressureStatusRearLeft": {
"timeStamp": "2023-01-15T12:05:00.000Z",
"value": "OK"
},
"tirePressureStatusValidRearLeft": {
"timeStamp": "2023-01-15T12:05:00.000Z",
"value": "invalid"
},
"tirePressureStatusRearRight": {
"timeStamp": "2023-01-15T12:05:00.000Z",
"value": "OK"
},
"tirePressureStatusValidRearRight": {
"timeStamp": "2023-01-15T12:05:00.000Z",
"value": "invalid"
},
"batteryLevel": {
"timeStamp": "2023-01-10T08:00:00.000Z",
"value": 59.400002
},
"chargerState": {
"timeStamp": "2023-01-15T12:00:00.000Z",
"value": "charging_ready"
},
"batteryLimit": {
"timeStamp": "2023-01-15T12:05:00.000Z",
"value": 70
},
"remoteChargingAvailable": {
"timeStamp": "2023-01-15T12:05:00.000Z",
"value": 0
},
"batteryHvThermalEvent": {
"timeStamp": "2023-01-10T08:00:00.000Z",
"value": "off"
},
"rangeThreshold": {
"timeStamp": "2023-01-15T12:00:00.000Z",
"value": "vehicle_range_normal"
},
"distanceToEmpty": {
"timeStamp": "2023-01-15T12:00:00.000Z",
"value": 307
},
"otaAvailableVersionGitHash": {
"timeStamp": "2023-01-15T12:05:00.000Z",
"value": ""
},
"otaAvailableVersionNumber": {
"timeStamp": "2023-01-15T12:05:00.000Z",
"value": 0
},
"otaAvailableVersionWeek": {
"timeStamp": "2023-01-15T12:05:00.000Z",
"value": 0
},
"otaAvailableVersionYear": {
"timeStamp": "2023-01-15T12:05:00.000Z",
"value": 0
},
"otaCurrentVersionGitHash": {
"timeStamp": "2023-01-15T12:05:00.000Z",
"value": "9804525e"
},
"otaCurrentVersionNumber": {
"timeStamp": "2023-01-15T12:05:00.000Z",
"value": 0
},
"otaCurrentVersionWeek": {
"timeStamp": "2023-01-15T12:05:00.000Z",
"value": 14
},
"otaCurrentVersionYear": {
"timeStamp": "2023-01-15T12:05:00.000Z",
"value": 2023
},
"otaDownloadProgress": {
"timeStamp": "2023-01-15T12:05:00.000Z",
"value": 0
},
"otaInstallDuration": {
"timeStamp": "2023-01-15T12:05:00.000Z",
"value": 0
},
"otaInstallProgress": {
"timeStamp": "2023-01-15T12:05:00.000Z",
"value": 0
},
"otaInstallReady": {
"timeStamp": "2023-01-10T08:00:00.000Z",
"value": "ota_available"
},
"otaInstallTime": {
"timeStamp": "2023-01-15T12:05:00.000Z",
"value": 0
},
"otaInstallType": {
"timeStamp": "2023-01-15T12:05:00.000Z",
"value": "Convenience"
},
"otaStatus": {
"timeStamp": "2023-01-15T12:05:00.000Z",
"value": "Idle"
},
"otaCurrentStatus": {
"timeStamp": "2023-01-15T12:05:00.000Z",
"value": "Install_Success"
},
"cabinClimateInteriorTemperature": {
"timeStamp": "2023-01-15T12:00:00.000Z",
"value": 24
},
"cabinPreconditioningStatus": {
"timeStamp": "2023-01-15T12:05:00.000Z",
"value": "undefined"
},
"cabinPreconditioningType": {
"timeStamp": "2023-01-15T12:05:00.000Z",
"value": "NONE"
},
"petModeStatus": {
"timeStamp": "2023-01-10T08:00:00.000Z",
"value": "Off"
},
"petModeTemperatureStatus": {
"timeStamp": "2023-01-10T08:00:00.000Z",
"value": "Default"
},
"cabinClimateDriverTemperature": {
"timeStamp": "2023-01-15T12:00:00.000Z",
"value": 22
},
"gearGuardVideoStatus": {
"timeStamp": "2023-01-15T12:00:00.000Z",
"value": "Enabled"
},
"gearGuardVideoMode": {
"timeStamp": "2023-01-15T12:00:00.000Z",
"value": "Away_From_Home"
},
"gearGuardVideoTermsAccepted": {
"timeStamp": "2023-01-15T12:00:00.000Z",
"value": "true"
},
"defrostDefogStatus": {
"timeStamp": "2023-01-15T12:00:00.000Z",
"value": "Off"
},
"steeringWheelHeat": {
"timeStamp": "2023-01-15T12:00:00.000Z",
"value": "Off"
},
"seatFrontLeftHeat": {
"timeStamp": "2023-01-15T12:00:00.000Z",
"value": "Off"
},
"seatFrontRightHeat": {
"timeStamp": "2023-01-15T12:00:00.000Z",
"value": "Off"
},
"seatRearLeftHeat": {
"timeStamp": "2023-01-15T12:00:00.000Z",
"value": "Off"
},
"seatRearRightHeat": {
"timeStamp": "2023-01-15T12:00:00.000Z",
"value": "Off"
},
"chargerStatus": {
"timeStamp": "2023-01-15T12:05:00.000Z",
"value": "chrgr_sts_not_connected"
},
"seatFrontLeftVent": {
"timeStamp": "2023-01-15T12:00:00.000Z",
"value": "Off"
},
"seatFrontRightVent": {
"timeStamp": "2023-01-15T12:00:00.000Z",
"value": "Off"
},
"chargerDerateStatus": null,
"driveMode": {
"timeStamp": "2023-01-10T08:00:00.000Z",
"value": "everyday"
},
"serviceMode": {
"timeStamp": "2023-01-15T12:00:00.000Z",
"value": "off"
}
}
}
}