---
title: "이용 내역서 상세 조회"
method: GET
path: "/reservations/{reservationId}"
tags: ["CarSharing Reservation"]
---

# 이용 내역서 상세 조회

`GET /reservations/{reservationId}`

## Request

- Base URL: `http://api-internal.capora.ai:443`
- URL: `http://api-internal.capora.ai:443/reservations/{reservationId}`
- Auth: none declared

이용 내역서 목록 조회 > 이용 내역서 상세 조회

## Path parameters

- `reservationId` integer, required

## Response `200`

OK

- ReservationDetailResponse
  - `csReservationId` integer, required: 예약 아이디
  - `itemId` integer, required: 개별 상품 아이디(ex. vehicleId)
  - `reservationStartAt` string, date-time, required: 예약 시작 시간
  - `reservationEndAt` string, date-time, required: 예약 종료 시간
  - `reservationStatusTypeCode` string, required: 예약 상태 타입
  - `parkingLocation` string: 주차 위치
  - `energyAmount` integer: 충전량
  - `isChargingYn` string: 충전기 체결 여부
  - `csVehicle` VehicleDetailResponse, required
    - `vehicleId` integer, required: 개별차량 아이디
    - `vehicleGroupId` integer, required: 차량 그룹 아이디
    - `representativeVehicleName` string, required: 대표차량 명
    - `trimName` string: 차량 트림명
    - `vehicleNumber` string, required: 차량 번호
    - `capacity` integer: 정원
    - `vehicleImageFileId` string: 차량 이미지 아이디
    - `insuranceCompanyDescription` string: 보험사 정보
    - `approverName` string: 승인담당자 이름
    - `approverEmail` string: 승인담당자 이메일
    - `reservationUnitMinutes` integer: 예약 단위(분)
    - `recurrenceEnabled` string: 반복 예약 가능 여부
    - `vehicleOptions` string[], required: 차량 옵션 목록
    - `carTypeName` string: 차종명
    - `fuelTypeName` string: 연료타입명
    - `gearboxTypeName` string: 변속기타입명
    - `fuelEfficiencyDescription` string: 연료 효율 설명
  - `penalty` PenaltyForReservationResponse
    - `hasPenalty` boolean, required: 패널티 적용 중 여부
    - `penaltyCount` integer: 패널티 누적 횟수
    - `penaltyReason` string: 패널티 사유
    - `penaltyDuration` integer: 패널티 시간
    - `penaltyTotalDuration` integer: 패널티 누적 시간
  - `approvalHistory` ApprovalHistoryDetailSummary
    - `reservationId` integer, required
    - `requestReasonType` 'WORK_OUTSIDE' | 'BUSINESS_TRIP' | 'SITE_VISIT' | 'EVENT_PARTICIPATION' | 'TRAINING_ATTENDANCE' | 'CARGO_TRANSPORT' | 'EXTERNAL_MEETING' | 'EMERGENCY_SUPPORT' | 'VEHICLE_TEST' | 'ETC', required
    - `requestMessage` string
    - `approvalMethod` 'APPROVE' | 'REJECT' | 'PENDING' | 'CANCELED', required
    - `approvalMessage` string
  - `penaltyPolicy` PenaltyPolicySummary
    - `useLateReturnPenalty` boolean, required: 지연 반납 시 패널티 여부
    - `lateReturnPenaltyThresholdMinutes` integer, required: 최소 지연 기준
    - `useSameDayCancelPenalty` boolean, required: 당일 예약 취소 시 패널티 여부
    - `totalPenaltyCountWindowUnit` 'NONE' | 'DAY' | 'WEEK' | 'MONTH' | 'QUARTER' | 'HALF_YEAR' | 'YEAR', required: 패널티 카운트 초기화 주기 타입
    - `blacklistThreshold` integer, required: 이용불가 등록 기준
    - `blacklistDuration` integer, required: 이용불가 기간(일 단위)
  - `isCancelOnTheDay` boolean, required: 당일 취소 팝업 노출 여부
  - `usedTime` string, required

---

[API](https://skmtc.dev/capora/apis/capora-api.md) - [All operations](https://skmtc.dev/capora/apis/capora-api/llms.txt) - [OpenAPI document](https://skmtc.dev/capora/apis/capora-api/revisions/42e54cb2362a?raw)