Step 상태 조회하기

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

Request

요청 호출 방식과 각 요청 헤더에 포함될 내용에 안내합니다. 요청이 실패할 경우 문제 해결하기에서 에러에 대한 상세 내용을 확인하세요.

Endpoint

표 1 | 호출 방식
MethodURL
GEThttps://open-api-logistics.kakaomobility.com/
goa-sandbox-service/api/v2/orders/{partnerOrderId}/steps/{stepId}

Header

표 2 | 요청 헤더
ParameterDescription
authorizationAPI 인증 값
vendorkakaoT 퀵∙도보 배송 API Sandbox에서 발급받은 Vendor 아이디

Path Parameter

표 3 | Path Parameter
NameTypeDescription
partnerOrderIdString연동사 주문 ID
stepIdString조회할 Step ID (예: PICKUP, DROPOFF 등)

요청 코드 예제

curl -X 'GET' \
  'https://open-api-logistics.kakaomobility.com/goa-sandbox-service/api/v2/orders/${partnerOrderId}/steps/${stepId}' \
  -H 'accept: application/json' \
  -H 'vendor: ${vendor_id}' \
  -H 'Authorization: XXX'

Response

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

응답 코드 예제

{
  "stepId": "stp_way_01",
  "status": "waiting",
  "statusUpdatedAt": "2026-03-26T15:42:11.120+09:00",
  "estimatedEndedAt": "2026-03-26T16:05:00.000+09:00",
  "endedAt": "2026-03-26T16:03:00.000+09:00",
  "location": {
    "basicAddress": "서울특별시 강남구 삼성동 159",
    "detailAddress": "3층",
    "latitude": 37.5087956,
    "longitude": 127.0632929
  },
  "contact": {
    "name": "경유지1 사람 이름",
    "phone": "01010000003"
  }
}

응답 주요 필드(실제 구현 중심)는 다음과 같습니다.

표 4 | 응답 필드
NameTypeDescriptionRequired
stepIdstring스텝 ID선택
statusstring스텝 상태선택
statusUpdatedAtDateTime상태 변경 시간선택
estimatedEndedAtDateTime예상 종료 시간선택
endedAtDateTime실제 종료 시간선택
Object위치 정보선택
basicAddressstring기본 주소선택
detailAddressstring상세 주소선택
latitudenumber위도선택
longitudenumber경도선택
Object연락처 정보선택
namestring담당자 이름선택
phonestring연락처선택