买新能源二手车时，除了车龄和里程，动力电池也是一个绕不开的问题

两辆年份、里程接近的新能源车，电池状态不一定相同。实际使用过程中，电池健康度、衰减情况、充电习惯、当前续航等数据，都可以帮助我们从不同角度了解动力电池目前的状态

如果业务中需要批量处理这类信息，仅靠人工查看车辆资料会比较麻烦。新能源电池报告查询 API 以 VIN 车架号作为查询条件，可以返回电池健康度、衰减速率、当前满电续航、充电相关数据、电池基础参数、一致性检测以及动力电池年检信息等内容

探数API的新能源电池报告API查得率为 80%，支持商用车查询

📌 接口功能总结：输入车辆 VIN，查询该车辆的新能源电池健康及相关检测数据。返回结果不只有 SOH，还包含衰减、续航、充电、电池参数和动力电池年检等信息

VIN 能查到哪些新能源电池数据？

接口返回的字段比较多，如果直接看完整 JSON，不太容易快速找到自己需要的数据
按返回内容划分，主要包括以下几类：

实际接入时，不一定需要把全部字段都展示出来。二手车估值、售后维保、车辆报告等不同业务，可以根据自己的页面和业务逻辑选择需要的字段

SOH、电池评级和衰减速率怎么看？

电池健康相关的数据中，比较容易被关注的是 soh、battery_level 和 battery_degradation_rate。

续航、容量和表显里程

除了电池健康相关指标，接口还会返回表显里程、续航以及容量相关数据

{
  "total_mileage": "21333",
  "total_mileage_date": "2024-12-31",
  "full_capacity_assessment": "-1",
  "full_endurance": "165",
  "battery_capacity_score": "96",
  "endurance_nominal": "172"
}

充电相关数据

返回结果中还有一组与充电有关的字段：

{
  "avg_start_soc": "24",
  "avg_end_soc": "93",
  "depth_of_charge": "69",
  "fast_charging_year_rate": "0"
}

分别对应：

• avg_start_soc：平均充电起始 SOC
• avg_end_soc：平均充电终止 SOC
• depth_of_charge：充电深度 %
• fast_charging_year_rate：近一年快充占比 %
  如果页面需要展示车辆电池的使用情况，这组数据可以和 SOH、电池衰减速率等信息结合使用

  电池一致性与年检信息

  接口除了返回单独的温度、电压、内阻一致性得分，还提供了 battery_evaluation_info，用于返回更具体的电池一致性对比信息
  例如：

  "battery_evaluation_info": [
  {
    "ownData": "3.9",
    "evaluationName": "历史单体平均温差（℃）",
    "otherData": "4.1",
    "evaluationResult": "优秀"
  },
  {
    "ownData": "114",
    "evaluationName": "历史单体平均压差（mV）",
    "otherData": "120",
    "evaluationResult": "优秀"
  }
  ]
  

  相比只返回一个分数，这部分数据同时给出了检测项目、本车数据、对比数据和评价结果，更适合用于车辆检测报告中的明细展示
  动力电池年检数据则通过 annual_inspection_info 返回：

  "annual_inspection_info": [
  {
    "annualInspectionName": "动力蓄电池最高温度（℃）",
    "annualInspectionValue": "≤65.0",
    "annualInspectionResult": "合格",
    "ownValue": "58"
  },
  {
    "annualInspectionName": "单体蓄电池最高电压（V）",
    "annualInspectionValue": "≤3.85",
    "annualInspectionResult": "合格",
    "ownValue": "3.78"
  }
  ]
  

  其中：

实际返回的检测项目应以具体车辆查询结果为准

哪些业务会用到？

新能源二手车估值

新能源二手车估值不能只看车龄和表显里程
通过 VIN 查询电池报告，可以进一步获取车辆的电池健康度、衰减速率、当前满电续航、电池评级以及部分电池基础参数，为车辆信息核验和估值提供参考
这些数据属于参考信息，最终估值仍需要结合车况、车型、年份、里程以及其他检测结果综合判断

售后维保

售后维保场景更关心动力电池当前的状态
接口中的电池健康度、衰减速率、温度一致性、电压一致性、内阻一致性、电池报警信息和年检信息，可以用于整理车辆动力电池状态
是否达到厂家质保、维修或更换标准，则需要结合具体厂家的质保政策和实际检测要求判断，不能仅凭接口中的某一个字段直接下结论

车辆电池报告

如果平台本身提供车辆详情页、检测报告或车辆档案，可以按照“车辆信息—电池健康—续航与容量—充电数据—一致性检测—年检信息”的方式整理接口返回结果
这样既保留原始数据，也方便用户阅读

接口怎么调用？

• 接口地址：https://www.tanshuapi.com/market/detail-158
• 请求方式：GET / POST
• 返回格式：JSON
• 使用对象：企业实名用户
• 查得率：80%
• 车辆支持：支持商用车
• 计费说明：查得计费

  请求参数

请求示例

https://api.tanshuapi.com/api/car_battery_state_v2/v1/index?key=YOUR_API_KEY&vin=车辆VIN

完整 JSON 返回示例

下面是当前接口资料提供的完整返回示例：

{
  "code": 1,
  "msg": "操作成功",
  "data": {
    "vin": "LSVAX60E8K2018698",
    "soh": "96",
    "battery_level": "S",
    "battery_degradation_rate": "2",
    "engine_type": "插电式混合动力汽车",
    "record_date": "2024-08",
    "check_date": "2024-08",
    "total_mileage": "21333",
    "total_mileage_date": "2024-12-31",
    "battery_valuation": "6720",
    "battery_maintenance_msg": "",
    "temperature_accord_score": "95",
    "voltage_accord_score": "95",
    "full_capacity_assessment": "-1",
    "ir_accord_score": "93",
    "full_endurance": "165",
    "battery_capacity_score": "96",
    "battery_model": "",
    "isolation_score": "95",
    "battery_health_val": "95",
    "avg_start_soc": "24",
    "avg_end_soc": "93",
    "depth_of_charge": "69",
    "fast_charging_year_rate": "0",
    "enterprise_name": "山东欣旺达新能源有限公司",
    "battery_type": "磷酸铁锂",
    "battery_warranty": "8年或15万公里",
    "power_change": "否",
    "battery_energy_nominal": "35",
    "endurance_nominal": "172",
    "fuel_consumption": "6.90",
    "energy_density": "134.33",
    "battery_weight": "266",
    "battery_level1_alarm": "优秀",
    "battery_level2_alarm": "优秀",
    "battery_level3_alarm": "优秀",
    "battery_evaluation_info": [
      {
        "ownData": "3.9",
        "evaluationName": "历史单体平均温差（℃）",
        "otherData": "4.1",
        "evaluationResult": "优秀"
      },
      {
        "ownData": "114",
        "evaluationName": "历史单体平均压差（mV）",
        "otherData": "120",
        "evaluationResult": "优秀"
      }
    ],
    "annual_inspection_info": [
      {
        "annualInspectionName": "动力蓄电池最高温度（℃）",
        "annualInspectionValue": "≤65.0",
        "annualInspectionResult": "合格",
        "ownValue": "58"
      },
      {
        "annualInspectionName": "单体蓄电池最高电压（V）",
        "annualInspectionValue": "≤3.85",
        "annualInspectionResult": "合格",
        "ownValue": "3.78"
      },
      {
        "annualInspectionName": "单体蓄电池电压极差（V）",
        "annualInspectionValue": "≤0.3",
        "annualInspectionResult": "合格",
        "ownValue": "0.09"
      },
      {
        "annualInspectionName": "单体蓄电池最低电压（V）",
        "annualInspectionValue": "≥1.5",
        "annualInspectionResult": "合格",
        "ownValue": "3.69"
      }
    ]
  }
}

完整示例可以帮助开发人员确认字段结构，但不代表每一次查询都会返回完全相同的字段值或有效内容。实际使用时应以具体 VIN 的接口返回结果为准，并做好空值及特殊值处理。

错误码怎么处理？

服务级错误码

服务级错误码主要反映当前这次业务查询的状态：

其中，215802 表示查无记录，不应直接等同于接口系统异常

系统级错误码

系统级错误码则主要涉及 KEY、权限、请求来源和接口状态：

开发时可以将业务查询结果和系统错误分开处理。这样用户遇到“查无记录”时，不会被错误提示成“接口异常”；KEY 失效或权限不足时，也可以快速定位到接入配置问题

API 速查

总结

新能源电池报告查询 API 更适合需要通过 VIN 获取结构化电池数据的业务场景。相比只看一个 SOH，接口还提供衰减、续航、充电、一致性检测和年检等相关字段，可以按实际业务需要选择使用。
接入时需要特别留意数据日期、空值和特殊返回值，并以实际 VIN 的查询结果为准。