curl --request GET \
--url https://gw-staging.delivered.co.kr/global-ship/open-api/v1/shipments/{masterNumber}/tracking \
--header 'Authorization: Bearer <token>'import requests
url = "https://gw-staging.delivered.co.kr/global-ship/open-api/v1/shipments/{masterNumber}/tracking"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://gw-staging.delivered.co.kr/global-ship/open-api/v1/shipments/{masterNumber}/tracking', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://gw-staging.delivered.co.kr/global-ship/open-api/v1/shipments/{masterNumber}/tracking",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://gw-staging.delivered.co.kr/global-ship/open-api/v1/shipments/{masterNumber}/tracking"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://gw-staging.delivered.co.kr/global-ship/open-api/v1/shipments/{masterNumber}/tracking")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://gw-staging.delivered.co.kr/global-ship/open-api/v1/shipments/{masterNumber}/tracking")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"masterNumber": "D04510082600064",
"shipmentStatus": "IN_DELIVERY",
"requestedAt": "2026-09-10T02:11:33",
"shippedOutAt": "2026-09-12T08:40:00",
"carrier": "DELIVERED_STANDARD_A",
"trackingEvents": [
{
"status": "In Transit",
"description": "Departed from facility",
"location": "ICN",
"occurredAt": "2024-06-24T09:22:00Z"
}
]
}{
"httpStatus": 401,
"message": "인증에 실패했습니다. 인증 정보가 없거나 위변조·만료되었습니다.",
"errorCode": "AUTHENTICATION_FAILED"
}{
"httpStatus": 403,
"message": "다른 고객사의 배송 건입니다.",
"errorCode": "SHIPMENT_ACCESS_DENIED"
}{
"httpStatus": 404,
"message": "존재하지 않는 DK 입고 송장번호입니다.",
"errorCode": "SHIPMENT_NOT_FOUND",
"masterNumbers": [
"D04510082600099"
]
}{
"httpStatus": 500,
"message": "서버 오류가 발생했습니다.",
"errorCode": "INTERNAL_SERVER_ERROR"
}배송 정보 조회
DK 입고 송장번호로 배송 상태와 트래킹 정보를 조회합니다. 배송 상태(shipmentStatus)는 9종이며 DK 트래킹 페이지가 보여주는 값과 같습니다. 상태값 표는 배송 API 시작하기에 있습니다.
운송사(carrier)는 송장 발행 전에도 반환됩니다. 트래킹 이벤트(trackingEvents)는 라스트 마일 송장이 아직 발행되지 않았거나 트래킹 조회에 실패하면 빈 배열([]) 이 되며, 필드 자체가 생략되지는 않습니다. 트래킹 조회에 실패해도 응답은 200이고 배송 상태는 정상 반환됩니다.
curl --request GET \
--url https://gw-staging.delivered.co.kr/global-ship/open-api/v1/shipments/{masterNumber}/tracking \
--header 'Authorization: Bearer <token>'import requests
url = "https://gw-staging.delivered.co.kr/global-ship/open-api/v1/shipments/{masterNumber}/tracking"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://gw-staging.delivered.co.kr/global-ship/open-api/v1/shipments/{masterNumber}/tracking', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://gw-staging.delivered.co.kr/global-ship/open-api/v1/shipments/{masterNumber}/tracking",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://gw-staging.delivered.co.kr/global-ship/open-api/v1/shipments/{masterNumber}/tracking"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://gw-staging.delivered.co.kr/global-ship/open-api/v1/shipments/{masterNumber}/tracking")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://gw-staging.delivered.co.kr/global-ship/open-api/v1/shipments/{masterNumber}/tracking")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"masterNumber": "D04510082600064",
"shipmentStatus": "IN_DELIVERY",
"requestedAt": "2026-09-10T02:11:33",
"shippedOutAt": "2026-09-12T08:40:00",
"carrier": "DELIVERED_STANDARD_A",
"trackingEvents": [
{
"status": "In Transit",
"description": "Departed from facility",
"location": "ICN",
"occurredAt": "2024-06-24T09:22:00Z"
}
]
}{
"httpStatus": 401,
"message": "인증에 실패했습니다. 인증 정보가 없거나 위변조·만료되었습니다.",
"errorCode": "AUTHENTICATION_FAILED"
}{
"httpStatus": 403,
"message": "다른 고객사의 배송 건입니다.",
"errorCode": "SHIPMENT_ACCESS_DENIED"
}{
"httpStatus": 404,
"message": "존재하지 않는 DK 입고 송장번호입니다.",
"errorCode": "SHIPMENT_NOT_FOUND",
"masterNumbers": [
"D04510082600099"
]
}{
"httpStatus": 500,
"message": "서버 오류가 발생했습니다.",
"errorCode": "INTERNAL_SERVER_ERROR"
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
DK 입고 송장번호. 배송 신청 API 응답의 masterNumber 값입니다.
Response
OK
DK 입고 송장번호
"D04510082600064"
배송 상태. 신청완료(CONFIRM_ORDER) · 입고완료(RECEIVING_COMPLETE) · 입고보류(RECEIVING_ON_HOLD) · 출고대기(PREPARE_SHIP) · 출고완료(SHIPPED_OUT) · 배송중(IN_DELIVERY) · 배송완료(DELIVERED) · 반송완료(SHIPBACK) · 취소(CANCEL)
CONFIRM_ORDER, RECEIVING_COMPLETE, RECEIVING_ON_HOLD, PREPARE_SHIP, SHIPPED_OUT, IN_DELIVERY, DELIVERED, SHIPBACK, CANCEL "IN_DELIVERY"
배송 신청 일자
"2026-09-10T02:11:33"
트래킹 이벤트. 송장 미발행이거나 트래킹 조회에 실패하면 빈 배열([])입니다. 필드가 생략되지는 않습니다.
Show child attributes
Show child attributes
출고 일자. 출고 전이면 비어 있습니다.
"2026-09-12T08:40:00"
배송을 담당하는 운송사. 송장 발행 전에도 반환되며, 운송사가 지정되지 않았으면 비어 있습니다.
DELIVERED_STANDARD·DELIVERED_STANDARD_A— 딜리버드 스탠다드DELIVERED_EXPRESS— 딜리버드 익스프레스DHL·UPS·FEDEX·EMS등 — 해당 운송사가 직접 배송하는 경우 운송사 코드가 그대로 반환됩니다.
"DELIVERED_STANDARD_A"