> ## Documentation Index
> Fetch the complete documentation index at: https://developers-partners.delivered.co.kr/llms.txt
> Use this file to discover all available pages before exploring further.
# 배송 정보 조회
> DK 입고 송장번호로 배송 상태와 트래킹 정보를 조회합니다. 배송 상태(`shipmentStatus`)는 9종이며 DK 트래킹 페이지가 보여주는 값과 같습니다. 상태값 표는 [배송 API 시작하기](/reference/global-ship/shipping-guide)에 있습니다.
운송사(`carrier`)는 송장 발행 전에도 반환됩니다. 트래킹 이벤트(`trackingEvents`)는 **라스트 마일 송장이 아직 발행되지 않았거나 트래킹 조회에 실패하면 빈 배열(`[]`)** 이 되며, 필드 자체가 생략되지는 않습니다. 트래킹 조회에 실패해도 응답은 200이고 배송 상태는 정상 반환됩니다.
웹훅을 제공하지 않습니다. 폴링 방식으로 주기 호출하는 것을 전제로 합니다.자세한 호출 순서와 식별자 흐름은 [배송 API 시작하기](/reference/global-ship/shipping-guide)를 참고하세요. 인증은 [API 키](/reference/using-api/api-keys) · [환경](/reference/using-api/environment) 문서를 따릅니다.
## OpenAPI
````yaml api-reference/global-ship-api.json GET /open-api/v1/shipments/{masterNumber}/tracking
openapi: 3.0.1
info:
title: Global Ship Open API
description: '-'
version: 1.0.0
servers:
- url: https://gw-staging.delivered.co.kr/global-ship
description: 테스트 환경
- url: https://gw.delivered.co.kr/global-ship
description: 운영 환경
security:
- accessToken: []
- Authorization: []
tags:
- name: 주문
description: 주문
paths:
/open-api/v1/shipments/{masterNumber}/tracking:
get:
tags:
- 배송
summary: 배송 정보 조회
description: >-
DK 입고 송장번호로 배송 상태와 트래킹 정보를 조회합니다. 배송 상태(`shipmentStatus`)는 9종이며 DK 트래킹
페이지가 보여주는 값과 같습니다. 상태값 표는 [배송 API
시작하기](/reference/global-ship/shipping-guide)에 있습니다.
운송사(`carrier`)는 송장 발행 전에도 반환됩니다. 트래킹 이벤트(`trackingEvents`)는 **라스트 마일 송장이
아직 발행되지 않았거나 트래킹 조회에 실패하면 빈 배열(`[]`)** 이 되며, 필드 자체가 생략되지는 않습니다. 트래킹 조회에
실패해도 응답은 200이고 배송 상태는 정상 반환됩니다.
웹훅을 제공하지 않습니다. 폴링 방식으로 주기 호출하는 것을 전제로 합니다.자세한 호출 순서와
식별자 흐름은 [배송 API 시작하기](/reference/global-ship/shipping-guide)를 참고하세요. 인증은
[API 키](/reference/using-api/api-keys) ·
[환경](/reference/using-api/environment) 문서를 따릅니다.
operationId: getTracking
parameters:
- name: masterNumber
in: path
required: true
description: DK 입고 송장번호. 배송 신청 API 응답의 `masterNumber` 값입니다.
schema:
type: string
example: D04510082600064
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/OpenApiTrackingResponse'
'401':
description: 인증에 실패했습니다. 인증 정보가 없거나 위변조·만료되었습니다.
content:
application/json:
schema:
$ref: '#/components/schemas/OpenApiErrorResponse'
example:
httpStatus: 401
message: 인증에 실패했습니다. 인증 정보가 없거나 위변조·만료되었습니다.
errorCode: AUTHENTICATION_FAILED
'403':
description: 다른 고객사의 배송 건입니다.
content:
application/json:
schema:
$ref: '#/components/schemas/OpenApiErrorResponse'
example:
httpStatus: 403
message: 다른 고객사의 배송 건입니다.
errorCode: SHIPMENT_ACCESS_DENIED
'404':
description: 존재하지 않는 DK 입고 송장번호입니다.
content:
application/json:
schema:
$ref: '#/components/schemas/OpenApiErrorResponse'
example:
httpStatus: 404
message: 존재하지 않는 DK 입고 송장번호입니다.
errorCode: SHIPMENT_NOT_FOUND
masterNumbers:
- D04510082600099
'500':
description: 서버 오류가 발생했습니다.
content:
application/json:
schema:
$ref: '#/components/schemas/OpenApiErrorResponse'
example:
httpStatus: 500
message: 서버 오류가 발생했습니다.
errorCode: INTERNAL_SERVER_ERROR
components:
schemas:
OpenApiTrackingResponse:
required:
- masterNumber
- shipmentStatus
- requestedAt
- trackingEvents
type: object
properties:
masterNumber:
type: string
description: DK 입고 송장번호
example: D04510082600064
shipmentStatus:
type: string
description: >-
배송 상태. 신청완료(`CONFIRM_ORDER`) · 입고완료(`RECEIVING_COMPLETE`) ·
입고보류(`RECEIVING_ON_HOLD`) · 출고대기(`PREPARE_SHIP`) ·
출고완료(`SHIPPED_OUT`) · 배송중(`IN_DELIVERY`) · 배송완료(`DELIVERED`) ·
반송완료(`SHIPBACK`) · 취소(`CANCEL`)
example: IN_DELIVERY
enum:
- CONFIRM_ORDER
- RECEIVING_COMPLETE
- RECEIVING_ON_HOLD
- PREPARE_SHIP
- SHIPPED_OUT
- IN_DELIVERY
- DELIVERED
- SHIPBACK
- CANCEL
requestedAt:
type: string
format: date-time
description: 배송 신청 일자
example: '2026-09-10T02:11:33'
shippedOutAt:
type: string
format: date-time
description: 출고 일자. 출고 전이면 비어 있습니다.
example: '2026-09-12T08:40:00'
carrier:
type: string
description: >-
배송을 담당하는 운송사. 송장 발행 전에도 반환되며, 운송사가 지정되지 않았으면 비어 있습니다.
- `DELIVERED_STANDARD` · `DELIVERED_STANDARD_A` — 딜리버드 스탠다드
- `DELIVERED_EXPRESS` — 딜리버드 익스프레스
- `DHL` · `UPS` · `FEDEX` · `EMS` 등 — 해당 운송사가 직접 배송하는 경우 운송사 코드가 그대로
반환됩니다.
example: DELIVERED_STANDARD_A
trackingEvents:
type: array
description: 트래킹 이벤트. 송장 미발행이거나 트래킹 조회에 실패하면 빈 배열(`[]`)입니다. 필드가 생략되지는 않습니다.
items:
$ref: '#/components/schemas/OpenApiTrackingEvent'
example:
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'
OpenApiErrorResponse:
type: object
description: 오픈 API 오류 응답
required:
- httpStatus
- message
properties:
httpStatus:
type: integer
description: HTTP 상태 코드
example: 404
message:
type: string
description: 오류 메시지
errorCode:
type: string
description: >-
실패 유형을 구분하는 코드. `AUTHENTICATION_FAILED` · `SHIPMENT_ACCESS_DENIED` ·
`SHIPMENT_NOT_FOUND` · `MASTER_NUMBERS_EMPTY` ·
`MASTER_NUMBERS_LIMIT_EXCEEDED` · `INVALID_REQUEST` ·
`DK_LABEL_CREATION_FAILED` · `INTERNAL_SERVER_ERROR`
example: SHIPMENT_NOT_FOUND
masterNumbers:
type: array
description: '`SHIPMENT_NOT_FOUND`일 때만 실립니다. 존재하지 않는 DK 입고 송장번호 목록입니다.'
items:
type: string
example:
- D04510082600099
OpenApiTrackingEvent:
type: object
description: 트래킹 이벤트
properties:
status:
type: string
description: 배송 상태값 (운송사 원문)
example: In Transit
description:
type: string
description: 설명
example: Departed from facility
location:
type: string
description: 위치
example: ICN
occurredAt:
type: string
description: 발생 시각 (UTC). 현지 시각은 제공하지 않습니다.
example: '2024-06-24T09:22:00Z'
securitySchemes:
accessToken:
type: http
scheme: bearer
bearerFormat: JWT
Authorization:
type: apiKey
description: 발급받은 시크릿 키
name: Authorization
in: header
````