Lucid API

[hourglass]

Hi,
I used the Unofficial Lucid API to grab the data from my vehicle. Link: https://testmycode.cc/
<snippet>

Field 1, battery: <br> &lt;class 'vehicle_state_service_pb2.BatteryState'&gt;:<br> Field 1, remaining_range: 230.0<br> Field 2, charge_percent: 35.50000052899122<br> Field 3, kwhr: 28.73999935761094<br> Field 4, capacity_kwhr: 80.9499981906265<br> Field 5, battery_health: WARNING_OFF (1)<br> Field 6, low_charge_level: WARNING_OFF (1)<br> Field 7, critical_charge_level: WARNING_OFF (1)<br> Field 9, preconditioning_status: BATTERY_PRECON_OFF (1)<br> Field 10, preconditioning_time_remaining: 255<br> Field 11, battery_health_level: 95.20000141859055<br> Field 13, bmu_software_version_major: 4<br> Field 14, bmu_software_version_minor: 12<br> Field 15, bmu_software_version_micro: 22<br> Field 16, battery_cell_type: BATTERY_CELL_TYPE_PANA_2170M (3)<br> Field 17, battery_pack_type: BATTERY_PACK_TYPE_AIR_16 (3)<br> Field 18, max_cell_temp: 32.300001971423626<br> Field 19, min_cell_temp: 29.500001929700375
<snippet>

Some questions if you don't mind... Is this data obtained in real time once you logged in?

Field 1, remaining_range: 230.0 ; But, currently this doesn't match what's shown in my Lucid App. App shows 142 miles remaining.

Field 4, capacity_kwhr: 80.9499981906265<br>

Field 11, battery_health_level: 95.20000141859055<br>

It seems to me, if I can read this Field 4 data correctly, my capacity is 80kWh (down from 88kWh original spec) so I have lost 9% ?
My vehicle build date is 9/2023 and I took delivery Sept 20th.

Field 11 is indicating current batt health/capacity? i.e. 95% ; but the above Field 4 suggests a loss of 9% already.

Seems confusing... and thus, any insights is most appreciated. Thanks.

142 miles = 228.5 km, so that field is probably in km

 

[tonybot]

Yep, the range is in km, and you must convert it to miles. The temperature is in degrees Celsius, not Fahrenheit.

The battery capacity and health data are a mystery to me as well. My Air manufactured in April 2024 shows 95.5%. I took a procession of it in mid-July. OGs in this group posted that this data is not precisely accurate, according to Lucid. I don't know how to explain these numbers. One theory I have is, this excludes 3-4 KW buffer Lucid keeps. Also, another discrepancy is range. I see this in my output too. Your remaining KW is 28.74 rounded. At EPA rated miles per kwh, you should be getting 28.74 x 4.76 = 136.8 miles. If Lucid is using EPA, 142 miles indicate 29.8kw remaining.

 

[borski]

Some questions if you don't mind... Is this data obtained in real time once you logged in?

Yes, although you’d have to log out and back in to refresh it.

Field 4, capacity_kwhr: 80.9499981906265<br>

Field 11, battery_health_level: 95.20000141859055<br>

It seems to me, if I can read this Field 4 data correctly, my capacity is 80kWh (down from 88kWh original spec) so I have lost 9% ?
My vehicle build date is 9/2023 and I took delivery Sept 20th.

Field 11 is indicating current batt health/capacity? i.e. 95% ; but the above Field 4 suggests a loss of 9% already.

Seems confusing... and thus, any insights is most appreciated. Thanks.

We do not know what the battery capacity means. We don’t know if there’s a reserve, of if it’s accurate at all. The battery health is a Lucid-provided metric, but we don’t know how it works or what it measures.

The majority of your degradation will happen in your first year of ownership; that is true of any battery-powered device, but especially EVs. After the first year, degradation slows down significantly.

The warranty is 70% capacity at 8 years. How you get there is up to you.

That said, after 2.75 years or so, my battery health is at 93.4%, and it was in the 95-96% range not too long ago in the first year, so your degradation seems reasonable, if the battery health percentage is to be trusted.

Meanwhile, my capacity says 105.71 kWh, which would be a 10.42% degradation, so I would trust the battery health number more. We simply don’t know what the capacity represents, and whether it includes everything or not. We don’t actually know that for battery health either, but the intent of that metric is at least more clear, even if we can’t guarantee accuracy.

 

[joec]

Hi,
I used the Unofficial Lucid API to grab the data from my vehicle. Link: https://testmycode.cc/
<snippet>

Field 1, battery: <br> &lt;class 'vehicle_state_service_pb2.BatteryState'&gt;:<br> Field 1, remaining_range: 230.0<br> Field 2, charge_percent: 35.50000052899122<br> Field 3, kwhr: 28.73999935761094<br> Field 4, capacity_kwhr: 80.9499981906265<br> Field 5, battery_health: WARNING_OFF (1)<br> Field 6, low_charge_level: WARNING_OFF (1)<br> Field 7, critical_charge_level: WARNING_OFF (1)<br> Field 9, preconditioning_status: BATTERY_PRECON_OFF (1)<br> Field 10, preconditioning_time_remaining: 255<br> Field 11, battery_health_level: 95.20000141859055<br> Field 13, bmu_software_version_major: 4<br> Field 14, bmu_software_version_minor: 12<br> Field 15, bmu_software_version_micro: 22<br> Field 16, battery_cell_type: BATTERY_CELL_TYPE_PANA_2170M (3)<br> Field 17, battery_pack_type: BATTERY_PACK_TYPE_AIR_16 (3)<br> Field 18, max_cell_temp: 32.300001971423626<br> Field 19, min_cell_temp: 29.500001929700375
<snippet>

Some questions if you don't mind... Is this data obtained in real time once you logged in?

Field 1, remaining_range: 230.0 ; But, currently this doesn't match what's shown in my Lucid App. App shows 142 miles remaining.

Field 4, capacity_kwhr: 80.9499981906265<br>

Field 11, battery_health_level: 95.20000141859055<br>

It seems to me, if I can read this Field 4 data correctly, my capacity is 80kWh (down from 88kWh original spec) so I have lost 9% ?
My vehicle build date is 9/2023 and I took delivery Sept 20th.

Field 11 is indicating current batt health/capacity? i.e. 95% ; but the above Field 4 suggests a loss of 9% already.

Seems confusing... and thus, any insights is most appreciated. Thanks.

Field 1 is in kilometers. Most measurements coming from the API are in metric.

 

[mxp]

Ok. I just completed a charging session to 100% SOC on J1772 (6kwh max) for ~13 hours overnight.

Again, here's the stats I just pulled from Lucid API:
Field 1, battery: <br> &lt;class 'vehicle_state_service_pb2.BatteryState'&gt;:<br> Field 1, remaining_range: 648.0<br> Field 2, charge_percent: 100.00000149011612<br> Field 3, kwhr: 80.93999819085002<br> Field 4, capacity_kwhr: 80.93999819085002<br> Field 5, battery_health: WARNING_OFF (1)<br> Field 6, low_charge_level: WARNING_OFF (1)<br> Field 7, critical_charge_level: WARNING_OFF (1)<br> Field 9, preconditioning_status: BATTERY_PRECON_UNAVAILABLE (3)<br> Field 10, preconditioning_time_remaining: 255<br> Field 11, battery_health_level: 95.20000141859055<br> Field 13, bmu_software_version_major: 4<br> Field 14, bmu_software_version_minor: 12<br> Field 15, bmu_software_version_micro: 22<br> Field 16, battery_cell_type: BATTERY_CELL_TYPE_PANA_2170M (3)<br> Field 17, battery_pack_type: BATTERY_PACK_TYPE_AIR_16 (3)<br> Field 18, max_cell_temp: 28.900001920759678<br> Field 19, min_cell_temp: 27.700001902878284

Field 1, remaining_range: 648.0 ; Ok. This is 648km = 402 miles (matched the range on App)
Field 4, capacity_kwhr: 80.93999819085002 ; similar to before charging.
Field 11, battery_health_level: 95.20000141859055 ; similar to before charging.

NOTE: My SW is 2.3.10 ; and I noticed many people who went OTA 2.4.x claim better range or efficiency. Can we have some folks here on 2.4.x compare Field 13 to 15? Let's see if the software microcode changed at all. E.g. mine is bmu version 4.12.22

Field 13, bmu_software_version_major: 4<br>
Field 14, bmu_software_version_minor: 12<br>
Field 15, bmu_software_version_micro: 22<br>

 

[tonybot]

Here is mine running 2.4.4.

Field 13, bmu_software_version_major: 4
Field 14, bmu_software_version_minor: 13
Field 15, bmu_software_version_micro: 7

Microcode seems to have changed

 

[mxp]

Here is mine running 2.4.4.

Field 13, bmu_software_version_major: 4
Field 14, bmu_software_version_minor: 13
Field 15, bmu_software_version_micro: 7

Microcode seems to have changed

Interesting.... Thank you for checking.

 

[Buffalo Bob]

I just ran the API for the first time, and here is my data...

Field 11, battery_health_level: 97.80000145733356<br>
Field 13, bmu_software_version_major: 4<br>
Field 14, bmu_software_version_minor: 13<br>
Field 15, bmu_software_version_micro: 7

This is a 2023 Pure AWD which was both built and delivered in 11/23. I ran to a 100% charge on a slow charger about two months ago, and my range was 409 miles vs. the EPA 410 figure on the window sticker. The car has about 10.5k miles.

Please let me know if any other data would be useful to your analysis.