카카오 T 퀵/도보 배송 API

배송 소요 시간 조회

출발지·경유지·도착지 정보를 입력하면 배송 예상 소요 시간 및 요금 정보를 조회할 수 있습니다.

해당 API를 사용하려면 Vendor ID와 API 키값이 필요합니다.
발급 방법은 시작하기의 Vendor ID 및 API 키 발급받기를 참고하세요.

Request

Endpoint

표 1 | 호출 방식
Method	URL
`POST`	https://open-api-logistics.kakaomobility.com/ goa-sandbox-service/api/v2/orders/estimate

Header

표 2 | 요청 헤더
Parameter	Description
authorization	API 인증 값
vendor	kakaoT 퀵∙도보 배송 API Sandbox에서 발급받은 Vendor 아이디

요청 코드 예제


curl -X 'POST' \
  'https://open-api-logistics.kakaomobility.com/goa-sandbox-service/api/v2/orders/estimate' \
  -H 'accept: application/json' \
  -H 'vendor:${vendor_id}' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: XXX' \
  -d '{
  "pickup": {
    "basicAddress": "경기도 성남시 분당구 판교역로 152",
    "detailAddress": "13층",
    "latitude": 37.3946095,
    "longitude": 127.1118735
  },
  "waypoints": [{
      "basicAddress": "경기도 성남시 분당구 판교역로 235",
      "detailAddress": "N동",
      "latitude": 37.4021,
      "longitude": 127.1085
  }],
  "dropoff": {
    "basicAddress": "경기도 성남시 분당구 정자동 49-4",
    "detailAddress": "202호",
    "latitude": 37.3595316,
    "longitude": 127.1052133
  },
  "wishTime": "2026-03-11T10:00:00+09:00",
  "verticalTypes": ["QUICK"]
}'

요청에 대한 Request 필드는 다음과 같습니다.

표 3 | Request 필드
Name	Type	Description	Required
	`Object`	출발지 정보	필수
`basicAddress`	String	기본 주소	필수
`detailAddress`	String	상세 주소	선택
`latitude`	Number	위도	필수
`longitude`	Number	경도	필수
	`Object[]`	경유지 정보 배열	선택
`basicAddress`	String	경유지 기본 주소	필수
`detailAddress`	String	경유지 상세 주소	선택
`latitude`	Number	경유지 위도	필수
`longitude`	Number	경유지 경도	필수
	`Object`	도착지 정보	필수
`basicAddress`	String	기본 주소	필수
`detailAddress`	String	상세 주소	선택
`latitude`	Number	위도	필수
`longitude`	Number	경도	필수
`wishTime`	`date-time`	예약 희망 시간	선택
`verticalTypes`	`VerticalType[]`	조회 대상 버티컬 현재는 `["QUICK"]`만 지원합니다.	필수

Response

응답 성공 시 요청 본문은 JSON 포맷으로 전달합니다.

응답 코드 예제

{
  "requestId": "a08110eb3257",
  "lists": [
    {
      "estimatedTime": 1800,
      "fleetOption": {
        "fleet": "DAMAS",
        "type": "MINIMUM"
      },
      "orderType": "QUICK",
      "totalFareAmount": 12000,
      "discountAmount": 1000
    }
  ]
}

응답 객체 정보는 다음과 같습니다.

표 4 | 응답 객체
Name	Type	Description
`requestId`	string	요청 트레이스 ID
	Result[]	배송시간 조회 결과
`estimatedTime`	int	예상 소요 시간(초)
	Object	차량 옵션
`fleet`	string	추천/조회된 플릿
`type`	string	지정 차량 여부 (MINIMUM / REQUIRED)
`orderType`	string	주문 타입
`totalFareAmount`	int	총 요금
`discountAmount`	int	할인 금액

* waypoints 전달 시 경유 기능이 있는orderType 인 QUICK QUICK_ECONOMY QUICK_EXPRESS 에만 반영됩니다.

kakaoT 퀵 • 도보 배송 API Sandbox