Get Battery Charging Status

Description

배터리 플러그인 연결 여부, 충전 상태(충전/방전), 잔량, 남은 충전 시간 등 현재 충전 상태를 조회합니다.

Endpoint

GET https://api.pleos.ai/v1/vehicles/{vin}/batteries

Request

curl

curl -X GET "https://api.pleos.ai/v1/vehicles/{vin}/batteries" \
  -H "Authorization: Bearer <your_access_token>" \
  -H "Brand: hyundai"

Header Params

파라미터	타입	설명	필수 여부
Authorization	string	액세스 토큰	Required
Brand	string	차량 브랜드(hyundai/kia/genesis)	Required

Path Params

파라미터	타입	설명	필수 여부
vin	string	차량 식별 번호(Vehicle Identification Number)	Required

Response

성공

200

{
  "data": {
    "charge": {
      "plugin": "connected",
      "status": "fastCharging",
      "charging": true,
      "stateOfCharge": 30.5,
      "batteryCapacity": 273960,
      "targetStateOfCharge": {
        "standard": 100,
        "quick": 100
      },
      "remainTime": 54
    },
    "timestamp": "2025-09-01T00:10:00Z"
  },
  "meta": {
    "code": 200,
    "message": "Success",
    "success": "true",
    "timestamp": "2025-09-01T11:00:00Z",
    "requestId": "835bdbd4-1105-4a8c-b438-a1b2c3d4f5g6"
  }
}

data 필드	타입	설명
charge	object	배터리 충전 정보
└─ plugin	string	플러그인 연결 상태 (disconnected, connected, invalid)
└─ status	string	배터리의 충전/방전 상태 - notCharging: 미충전 중 - charging: 완속 충전 - fastCharging: 급속 충전 - v2lOperating: V2L 동작 중 - v2lStop: V2L 정지 - v2xOperating: V2X 동작 중 - reservedCharging: 예약 충전 중 - wirelessCharging: 무선 충전 중
└─ charging	boolean	충전 중 여부
└─ stateOfCharge	number	배터리의 충전 상태 (단위: %, 범위: 0~100, 255: invalid)
└─ batteryCapacity	number	배터리의 최대 용량
└─ targetStateOfCharge	object	배터리의 목표 충전량
└────── standard	integer	저속/AC 충전 시 배터리의 목표 충전량 (단위: %, 범위: 0~100)
└────── quick	integer	고속/DC 충전 시 배터리의 목표 충전량 (단위: %, 범위: 0~100)
└─ remainTime	integer	남은 충전 시간 (단위: 분, 범위: 0~65535)
timestamp	string	차량 데이터 발생 시각 (UTC+0 기준) yyyy-MM-dd'T'HH:mm:ss'Z'

실패

4002

{
  "error": {
    "code": "4002",
    "message": "Invalid request parameters",
    "details": [],
    "timestamp": "2025-09-01T12:00:00Z",
    "requestId": "835bdbd4-1105-4a8c-b438-a1b2c3d4f5g6"
  }
}

[에러 코드]

실패 시 에러 코드에 대한 상세한 설명은 에러 코드를 참조합니다.