{
"httpStatus": 404,
"message": "존재하지 않는 DK 입고 송장번호입니다.",
"errorCode": "SHIPMENT_NOT_FOUND",
"masterNumbers": [
"D04510082600099"
]
}
{
"httpStatus": 500,
"message": "서버 오류가 발생했습니다.",
"errorCode": "INTERNAL_SERVER_ERROR"
}
배송 API
배송 정보 조회
DK 입고 송장번호로 배송 상태와 트래킹 정보를 조회합니다. 배송 상태(shipmentStatus)는 9종이며 DK 트래킹 페이지가 보여주는 값과 같습니다. 상태값 표는 배송 API 시작하기에 있습니다.
운송사(carrier)는 송장 발행 전에도 반환됩니다. 트래킹 이벤트(trackingEvents)는 라스트 마일 송장이 아직 발행되지 않았거나 트래킹 조회에 실패하면 빈 배열([]) 이 되며, 필드 자체가 생략되지는 않습니다. 트래킹 조회에 실패해도 응답은 200이고 배송 상태는 정상 반환됩니다.
해외 운송장번호. 라스트 마일 송장이 발행되기 전에는 null 이며, 필드 자체가 생략되지는 않습니다.
Example:
"1234567890123"
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"딜리버드 파트너스 개발자 센터","colors":{"primary":"#FF9123","light":"#FF9123","dark":"#FF9123"},"logo":{"light":"https://mintcdn.com/deliveredkorea/nWJ7e83AaZRK5B9H/logo/light.svg?fit=max\u0026auto=format\u0026n=nWJ7e83AaZRK5B9H\u0026q=85\u0026s=8ca84e82637f7edb2b349181a5b3a2af","dark":"https://mintcdn.com/deliveredkorea/nWJ7e83AaZRK5B9H/logo/dark.svg?fit=max\u0026auto=format\u0026n=nWJ7e83AaZRK5B9H\u0026q=85\u0026s=5d4948a599b180ebd3a9f697205f2957"},"favicon":"https://mintcdn.com/deliveredkorea/nWJ7e83AaZRK5B9H/favicon_250327.svg?fit=max\u0026auto=format\u0026n=nWJ7e83AaZRK5B9H\u0026q=85\u0026s=c33eda690fbff744bd6da8aa83ba6896","navbar":{"links":[{"href":"https://developers-partners.delivered.co.kr/contact-form","label":"문의하기"}],"primary":{"type":"button","label":"파트너스 콘솔","href":"https://partners.delivered.co.kr/service/login"}},"integrations":{},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"deliveredkorea","hasAudioNarration":false,"actualSubdomain":"deliveredkorea","customDomains":["developers-partners.delivered.co.kr"],"gitSource":{"type":"github","owner":"delivered-dev","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ab9fa18c6cd70013ee45f6a","collectionId":"0d06dfce-ec81-46bd-b1be-3fab20458d2a","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ab9fa18c6cd70013ee45f6a"},"entitlements":{},"buildId":"6ab9fa18c6cd70013ee45f6a","clientVersion":"0.0.4076","searchFilterCounts":[{"language":"default","tag":"API \u0026 SDK","count":21},{"language":"default","tag":"글로벌쉽","count":9},{"language":"default","tag":"가이드","count":7},{"language":"default","tag":"글로벌링크","count":7},{"language":"default","tag":"글로벌체크아웃","count":6},{"language":"default","tag":"배송 API","count":5},{"language":"default","tag":"상품 API","count":4},{"language":"default","tag":"주문 API","count":3},{"language":"default","tag":"OPEN API 이용 안내","count":3},{"language":"default","tag":"레퍼런스","count":2}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"reference/global-ship/api/get-shipment-tracking","slug":"/reference/global-ship/api/get-shipment-tracking","pageMetadata":{"title":"배송 정보 조회","openapi":"api-reference/global-ship-api.json GET /open-api/v1/shipments/{masterNumber}/tracking","description":"DK 입고 송장번호로 배송 상태와 트래킹 정보를 조회합니다. 배송 상태(`shipmentStatus`)는 9종이며 DK 트래킹 페이지가 보여주는 값과 같습니다. 상태값 표는 [배송 API 시작하기](/reference/global-ship/shipping-guide)에 있습니다.\n\n운송사(`carrier`)는 송장 발행 전에도 반환됩니다. 트래킹 이벤트(`trackingEvents`)는 **라스트 마일 송장이 아직 발행되지 않았거나 트래킹 조회에 실패하면 빈 배열(`[]`)** 이 되며, 필드 자체가 생략되지는 않습니다. 트래킹 조회에 실패해도 응답은 200이고 배송 상태는 정상 반환됩니다.\n\n\u003cWarning>웹훅을 제공하지 않습니다. 폴링 방식으로 주기 호출하는 것을 전제로 합니다.\u003c/Warning>자세한 호출 순서와 식별자 흐름은 [배송 API 시작하기](/reference/global-ship/shipping-guide)를 참고하세요. 인증은 [API 키](/reference/using-api/api-keys) · [환경](/reference/using-api/environment) 문서를 따릅니다.","href":"/reference/global-ship/api/get-shipment-tracking"},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n a: \"a\",\n code: \"code\",\n p: \"p\",\n strong: \"strong\",\n ..._provideComponents(),\n ...props.components\n }, {Warning} = _components;\n if (!Warning) _missingMdxReference(\"Warning\", true);\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"DK 입고 송장번호로 배송 상태와 트래킹 정보를 조회합니다. 배송 상태(\", _jsx(_components.code, {\n children: \"shipmentStatus\"\n }), \")는 9종이며 DK 트래킹 페이지가 보여주는 값과 같습니다. 상태값 표는 \", _jsx(_components.a, {\n href: \"/reference/global-ship/shipping-guide\",\n children: \"배송 API 시작하기\"\n }), \"에 있습니다.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"운송사(\", _jsx(_components.code, {\n children: \"carrier\"\n }), \")는 송장 발행 전에도 반환됩니다. 트래킹 이벤트(\", _jsx(_components.code, {\n children: \"trackingEvents\"\n }), \")는 \", _jsxs(_components.strong, {\n children: [\"라스트 마일 송장이 아직 발행되지 않았거나 트래킹 조회에 실패하면 빈 배열(\", _jsx(_components.code, {\n children: \"[]\"\n }), \")\"]\n }), \" 이 되며, 필드 자체가 생략되지는 않습니다. 트래킹 조회에 실패해도 응답은 200이고 배송 상태는 정상 반환됩니다.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(Warning, {\n children: \"웹훅을 제공하지 않습니다. 폴링 방식으로 주기 호출하는 것을 전제로 합니다.\"\n }), \"자세한 호출 순서와 식별자 흐름은 \", _jsx(_components.a, {\n href: \"/reference/global-ship/shipping-guide\",\n children: \"배송 API 시작하기\"\n }), \"를 참고하세요. 인증은 \", _jsx(_components.a, {\n href: \"/reference/using-api/api-keys\",\n children: \"API 키\"\n }), \" · \", _jsx(_components.a, {\n href: \"/reference/using-api/environment\",\n children: \"환경\"\n }), \" 문서를 따릅니다.\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\nfunction _missingMdxReference(id, component) {\n throw new Error(\"Expected \" + (component ? \"component\" : \"object\") + \" `\" + id + \"` to be defined: you likely forgot to import, pass, or provide it.\");\n}\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"배송 정보 조회","openapi":"api-reference/global-ship-api.json GET /open-api/v1/shipments/{masterNumber}/tracking","description":"DK 입고 송장번호로 배송 상태와 트래킹 정보를 조회합니다. 배송 상태(`shipmentStatus`)는 9종이며 DK 트래킹 페이지가 보여주는 값과 같습니다. 상태값 표는 [배송 API 시작하기](/reference/global-ship/shipping-guide)에 있습니다.\n\n운송사(`carrier`)는 송장 발행 전에도 반환됩니다. 트래킹 이벤트(`trackingEvents`)는 **라스트 마일 송장이 아직 발행되지 않았거나 트래킹 조회에 실패하면 빈 배열(`[]`)** 이 되며, 필드 자체가 생략되지는 않습니다. 트래킹 조회에 실패해도 응답은 200이고 배송 상태는 정상 반환됩니다.\n\n\u003cWarning>웹훅을 제공하지 않습니다. 폴링 방식으로 주기 호출하는 것을 전제로 합니다.\u003c/Warning>자세한 호출 순서와 식별자 흐름은 [배송 API 시작하기](/reference/global-ship/shipping-guide)를 참고하세요. 인증은 [API 키](/reference/using-api/api-keys) · [환경](/reference/using-api/environment) 문서를 따릅니다.","href":"/reference/global-ship/api/get-shipment-tracking"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["배송"],"summary":"배송 정보 조회","description":"DK 입고 송장번호로 배송 상태와 트래킹 정보를 조회합니다. 배송 상태(`shipmentStatus`)는 9종이며 DK 트래킹 페이지가 보여주는 값과 같습니다. 상태값 표는 [배송 API 시작하기](/reference/global-ship/shipping-guide)에 있습니다.\n\n운송사(`carrier`)는 송장 발행 전에도 반환됩니다. 트래킹 이벤트(`trackingEvents`)는 **라스트 마일 송장이 아직 발행되지 않았거나 트래킹 조회에 실패하면 빈 배열(`[]`)** 이 되며, 필드 자체가 생략되지는 않습니다. 트래킹 조회에 실패해도 응답은 200이고 배송 상태는 정상 반환됩니다.\n\n\u003cWarning>웹훅을 제공하지 않습니다. 폴링 방식으로 주기 호출하는 것을 전제로 합니다.\u003c/Warning>자세한 호출 순서와 식별자 흐름은 [배송 API 시작하기](/reference/global-ship/shipping-guide)를 참고하세요. 인증은 [API 키](/reference/using-api/api-keys) · [환경](/reference/using-api/environment) 문서를 따릅니다.","operationId":"getTracking","parameters":["6a6cea4d-46b2-4dec-8a19-d2feb8848673"],"responses":{"200":"6c2db8b9-4afd-4aac-9d35-955d0d468994","401":"e2db9049-d671-4c49-b4f6-34edbf94a7f2","403":"1ba66b07-441c-4b65-b0e7-3a47b26a9094","404":"0db9ed23-b078-4482-af5b-e85208426584","500":"e15d9dc0-f405-4553-b44b-31af37afb1ba"},"method":"get","type":"path","servers":["bb9959a8-a9c5-4108-9bee-7c2199bad07e","10d1c46d-9814-4ab7-902c-1be414b58c90"],"security":["55a56c85-a9c2-4f7d-b1dd-ad151270c4d7","f47e81f5-1915-49fb-96a8-b5beb8837dac"],"path":"/open-api/v1/shipments/{masterNumber}/tracking","baseUrlOptions":["https://gw-staging.delivered.co.kr/global-ship","https://gw.delivered.co.kr/global-ship"],"title":"배송 정보 조회","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"6a6cea4d-46b2-4dec-8a19-d2feb8848673":{"name":"masterNumber","in":"path","required":true,"description":"DK 입고 송장번호. 배송 신청 API 응답의 `masterNumber` 값입니다.","schema":{"type":"string","isRequired":true,"description":"DK 입고 송장번호. 배송 신청 API 응답의 `masterNumber` 값입니다.","uniqueKey":"","typeLabel":"string"},"example":"D04510082600064"}},"responses":{"6c2db8b9-4afd-4aac-9d35-955d0d468994":{"description":"OK","content":{"application/json":{"schema":{"required":["masterNumber","shipmentStatus","requestedAt","trackingEvents"],"type":"object","properties":{"masterNumber":{"type":"string","description":"DK 입고 송장번호","example":"D04510082600064","isRequired":true,"uniqueKey":"masterNumber","typeLabel":"string"},"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"],"isRequired":true,"uniqueKey":"shipmentStatus","typeLabel":"enum\u003cstring>"},"requestedAt":{"type":"string","format":"date-time","description":"배송 신청 일자","example":"2026-09-10T02:11:33","isRequired":true,"uniqueKey":"requestedAt","typeLabel":"string\u003cdate-time>"},"trackingEvents":{"type":"array","description":"트래킹 이벤트. 송장 미발행이거나 트래킹 조회에 실패하면 빈 배열(`[]`)입니다. 필드가 생략되지는 않습니다.","items":{"type":"object","description":"트래킹 이벤트","properties":{"status":{"type":"string","description":"배송 상태값 (운송사 원문)","example":"In Transit","uniqueKey":"trackingEvents.items.[INDEX].status","typeLabel":"string"},"description":{"type":"string","description":"설명","example":"Departed from facility","uniqueKey":"trackingEvents.items.[INDEX].description","typeLabel":"string"},"location":{"type":"string","description":"위치","example":"ICN","uniqueKey":"trackingEvents.items.[INDEX].location","typeLabel":"string"},"occurredAt":{"type":"string","description":"발생 시각 (UTC). 현지 시각은 제공하지 않습니다.","example":"2024-06-24T09:22:00Z","uniqueKey":"trackingEvents.items.[INDEX].occurredAt","typeLabel":"string"}},"uniqueKey":"trackingEvents.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"trackingEvents","typeLabel":"object[]"},"shippedOutAt":{"type":"string","format":"date-time","description":"출고 일자. 출고 전이면 비어 있습니다.","example":"2026-09-12T08:40:00","uniqueKey":"shippedOutAt","typeLabel":"string\u003cdate-time>"},"carrier":{"type":"string","description":"배송을 담당하는 운송사. 송장 발행 전에도 반환되며, 운송사가 지정되지 않았으면 비어 있습니다.\n- `DELIVERED_STANDARD` · `DELIVERED_STANDARD_A` — 딜리버드 스탠다드\n- `DELIVERED_EXPRESS` — 딜리버드 익스프레스\n- `DHL` · `UPS` · `FEDEX` · `EMS` 등 — 해당 운송사가 직접 배송하는 경우 운송사 코드가 그대로 반환됩니다.","example":"DELIVERED_STANDARD_A","uniqueKey":"carrier","typeLabel":"string"},"trackingNumber":{"type":"string","description":"해외 운송장번호. 라스트 마일 송장이 발행되기 전에는 `null` 이며, **필드 자체가 생략되지는 않습니다.**","example":"1234567890123","uniqueKey":"trackingNumber","typeLabel":"string"}},"example":{"masterNumber":"D04510082600064","shipmentStatus":"IN_DELIVERY","requestedAt":"2026-09-10T02:11:33","shippedOutAt":"2026-09-12T08:40:00","carrier":"DELIVERED_STANDARD_A","trackingNumber":"1234567890123","trackingEvents":[{"status":"In Transit","description":"Departed from facility","location":"ICN","occurredAt":"2024-06-24T09:22:00Z"}]},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"masterNumber":"D04510082600064","shipmentStatus":"IN_DELIVERY","requestedAt":"2026-09-10T02:11:33","shippedOutAt":"2026-09-12T08:40:00","carrier":"DELIVERED_STANDARD_A","trackingNumber":"1234567890123","trackingEvents":[{"status":"In Transit","description":"Departed from facility","location":"ICN","occurredAt":"2024-06-24T09:22:00Z"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"e2db9049-d671-4c49-b4f6-34edbf94a7f2":{"description":"인증에 실패했습니다. 인증 정보가 없거나 위변조·만료되었습니다.","content":{"application/json":{"schema":{"type":"object","description":"오픈 API 오류 응답","required":["httpStatus","message"],"properties":{"httpStatus":{"type":"integer","description":"HTTP 상태 코드","example":404,"isRequired":true,"uniqueKey":"httpStatus","typeLabel":"integer"},"message":{"type":"string","description":"오류 메시지","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"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","uniqueKey":"errorCode","typeLabel":"string"},"masterNumbers":{"type":"array","description":"`SHIPMENT_NOT_FOUND`일 때만 실립니다. 존재하지 않는 DK 입고 송장번호 목록입니다.","items":{"type":"string","uniqueKey":"masterNumbers.items.[INDEX]","typeLabel":"string"},"example":["D04510082600099"],"uniqueKey":"masterNumbers","typeLabel":"string[]"}},"uniqueKey":"","typeLabel":"object"},"example":{"httpStatus":401,"message":"인증에 실패했습니다. 인증 정보가 없거나 위변조·만료되었습니다.","errorCode":"AUTHENTICATION_FAILED"},"examples":{"Example":{"title":"Example","value":{"httpStatus":401,"message":"인증에 실패했습니다. 인증 정보가 없거나 위변조·만료되었습니다.","errorCode":"AUTHENTICATION_FAILED"}}},"exampleType":"examples"}},"exampleType":"examples"},"1ba66b07-441c-4b65-b0e7-3a47b26a9094":{"description":"다른 고객사의 배송 건입니다.","content":{"application/json":{"schema":{"type":"object","description":"오픈 API 오류 응답","required":["httpStatus","message"],"properties":{"httpStatus":{"type":"integer","description":"HTTP 상태 코드","example":404,"isRequired":true,"uniqueKey":"httpStatus","typeLabel":"integer"},"message":{"type":"string","description":"오류 메시지","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"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","uniqueKey":"errorCode","typeLabel":"string"},"masterNumbers":{"type":"array","description":"`SHIPMENT_NOT_FOUND`일 때만 실립니다. 존재하지 않는 DK 입고 송장번호 목록입니다.","items":{"type":"string","uniqueKey":"masterNumbers.items.[INDEX]","typeLabel":"string"},"example":["D04510082600099"],"uniqueKey":"masterNumbers","typeLabel":"string[]"}},"uniqueKey":"","typeLabel":"object"},"example":{"httpStatus":403,"message":"다른 고객사의 배송 건입니다.","errorCode":"SHIPMENT_ACCESS_DENIED"},"examples":{"Example":{"title":"Example","value":{"httpStatus":403,"message":"다른 고객사의 배송 건입니다.","errorCode":"SHIPMENT_ACCESS_DENIED"}}},"exampleType":"examples"}},"exampleType":"examples"},"0db9ed23-b078-4482-af5b-e85208426584":{"description":"존재하지 않는 DK 입고 송장번호입니다.","content":{"application/json":{"schema":{"type":"object","description":"오픈 API 오류 응답","required":["httpStatus","message"],"properties":{"httpStatus":{"type":"integer","description":"HTTP 상태 코드","example":404,"isRequired":true,"uniqueKey":"httpStatus","typeLabel":"integer"},"message":{"type":"string","description":"오류 메시지","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"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","uniqueKey":"errorCode","typeLabel":"string"},"masterNumbers":{"type":"array","description":"`SHIPMENT_NOT_FOUND`일 때만 실립니다. 존재하지 않는 DK 입고 송장번호 목록입니다.","items":{"type":"string","uniqueKey":"masterNumbers.items.[INDEX]","typeLabel":"string"},"example":["D04510082600099"],"uniqueKey":"masterNumbers","typeLabel":"string[]"}},"uniqueKey":"","typeLabel":"object"},"example":{"httpStatus":404,"message":"존재하지 않는 DK 입고 송장번호입니다.","errorCode":"SHIPMENT_NOT_FOUND","masterNumbers":["D04510082600099"]},"examples":{"Example":{"title":"Example","value":{"httpStatus":404,"message":"존재하지 않는 DK 입고 송장번호입니다.","errorCode":"SHIPMENT_NOT_FOUND","masterNumbers":["D04510082600099"]}}},"exampleType":"examples"}},"exampleType":"examples"},"e15d9dc0-f405-4553-b44b-31af37afb1ba":{"description":"서버 오류가 발생했습니다.","content":{"application/json":{"schema":{"type":"object","description":"오픈 API 오류 응답","required":["httpStatus","message"],"properties":{"httpStatus":{"type":"integer","description":"HTTP 상태 코드","example":404,"isRequired":true,"uniqueKey":"httpStatus","typeLabel":"integer"},"message":{"type":"string","description":"오류 메시지","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"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","uniqueKey":"errorCode","typeLabel":"string"},"masterNumbers":{"type":"array","description":"`SHIPMENT_NOT_FOUND`일 때만 실립니다. 존재하지 않는 DK 입고 송장번호 목록입니다.","items":{"type":"string","uniqueKey":"masterNumbers.items.[INDEX]","typeLabel":"string"},"example":["D04510082600099"],"uniqueKey":"masterNumbers","typeLabel":"string[]"}},"uniqueKey":"","typeLabel":"object"},"example":{"httpStatus":500,"message":"서버 오류가 발생했습니다.","errorCode":"INTERNAL_SERVER_ERROR"},"examples":{"Example":{"title":"Example","value":{"httpStatus":500,"message":"서버 오류가 발생했습니다.","errorCode":"INTERNAL_SERVER_ERROR"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"55a56c85-a9c2-4f7d-b1dd-ad151270c4d7":{"accessToken":{"type":"http","scheme":"bearer","bearerFormat":"JWT","scopes":[]}},"f47e81f5-1915-49fb-96a8-b5beb8837dac":{"Authorization":{"type":"apiKey","description":"발급받은 시크릿 키","name":"Authorization","in":"header","scopes":[]}}},"servers":{"bb9959a8-a9c5-4108-9bee-7c2199bad07e":{"url":"https://gw-staging.delivered.co.kr/global-ship","description":"테스트 환경"},"10d1c46d-9814-4ab7-902c-1be414b58c90":{"url":"https://gw.delivered.co.kr/global-ship","description":"운영 환경"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"JWT","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"accessToken","name":"Authorization"}],"title":"accessToken"},{"schemes":[{"scheme":{"type":"apiKey","description":"발급받은 시크릿 키","name":"Authorization","in":"header","scopes":[]},"schema":{"title":"Authorization","type":"string","description":"발급받은 시크릿 키","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"Authorization","name":"Authorization"}],"title":"Authorization"}]},"originalFileLocation":"api-reference/global-ship-api.json"},"subdomain":"deliveredkorea","siteName":"딜리버드 파트너스 개발자 센터","title":"배송 정보 조회 - 딜리버드 파트너스 개발자 센터","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-23T00:53:14.177Z","originalFileLocation":"reference/global-ship/api/get-shipment-tracking.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"DK 입고 송장번호로 배송 상태와 트래킹 정보를 조회합니다. 배송 상태(shipmentStatus)는 9종이며 DK 트래킹 페이지가 보여주는 값과 같습니다. 상태값 표는 배송 API 시작하기에 있습니다. 운송사(carrier)는 송장 발행 전에도 반환됩니다. 트래킹 이벤트(trackingEvents)는 라스트 마일 송장이 아직 발행되지 않았거나 트래킹 조회에 실패하면 빈 배열([]) 이 되며, 필드 자체가 생략되지는 않습니다. 트래킹 조회에 실패해도 응답은 200이고 배송 상태는 정상 반환됩니다. 웹훅을 제공하지 않습니다. 폴링 방식으로 주기 호출하는 것을 전제로 합니다.자세한 호출 순서와 식별자 흐름은 배송 API 시작하기를 참고하세요. 인증은 API 키 · 환경 문서를 따릅니다.\">\u003cmeta data-mint-head name=\"application-name\" content=\"딜리버드 파트너스 개발자 센터\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/deliveredkorea/T0pW9gCUVcpB_AaO/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/deliveredkorea/T0pW9gCUVcpB_AaO/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/deliveredkorea/T0pW9gCUVcpB_AaO/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/deliveredkorea/T0pW9gCUVcpB_AaO/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/deliveredkorea/T0pW9gCUVcpB_AaO/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/deliveredkorea/T0pW9gCUVcpB_AaO/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/deliveredkorea/T0pW9gCUVcpB_AaO/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/deliveredkorea/T0pW9gCUVcpB_AaO/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/deliveredkorea/T0pW9gCUVcpB_AaO/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"배송 정보 조회 - 딜리버드 파트너스 개발자 센터\">\u003cmeta data-mint-head property=\"og:description\" content=\"DK 입고 송장번호로 배송 상태와 트래킹 정보를 조회합니다. 배송 상태(shipmentStatus)는 9종이며 DK 트래킹 페이지가 보여주는 값과 같습니다. 상태값 표는 배송 API 시작하기에 있습니다. 운송사(carrier)는 송장 발행 전에도 반환됩니다. 트래킹 이벤트(trackingEvents)는 라스트 마일 송장이 아직 발행되지 않았거나 트래킹 조회에 실패하면 빈 배열([]) 이 되며, 필드 자체가 생략되지는 않습니다. 트래킹 조회에 실패해도 응답은 200이고 배송 상태는 정상 반환됩니다. 웹훅을 제공하지 않습니다. 폴링 방식으로 주기 호출하는 것을 전제로 합니다.자세한 호출 순서와 식별자 흐름은 배송 API 시작하기를 참고하세요. 인증은 API 키 · 환경 문서를 따릅니다.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"딜리버드 파트너스 개발자 센터\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developers-partners.delivered.co.kr/reference/global-ship/api/get-shipment-tracking\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://deliveredkorea.mintlify.site/_mintlify/api/og/v2?division=%EB%B0%B0%EC%86%A1+API\u0026amp;title=%EB%B0%B0%EC%86%A1+%EC%A0%95%EB%B3%B4+%EC%A1%B0%ED%9A%8C\u0026amp;description=DK+%EC%9E%85%EA%B3%A0+%EC%86%A1%EC%9E%A5%EB%B2%88%ED%98%B8%EB%A1%9C+%EB%B0%B0%EC%86%A1+%EC%83%81%ED%83%9C%EC%99%80+%ED%8A%B8%EB%9E%98%ED%82%B9+%EC%A0%95%EB%B3%B4%EB%A5%BC+%EC%A1%B0%ED%9A%8C%ED%95%A9%EB%8B%88%EB%8B%A4.+%EB%B0%B0%EC%86%A1+%EC%83%81%ED%83%9C%28%60shipmentStatus%60%29%EB%8A%94+9%EC%A2%85%EC%9D%B4%EB%A9%B0+DK+%ED%8A%B8%EB%9E%98%ED%82%B9+%ED%8E%98%EC%9D%B4%EC%A7%80%EA%B0%80+%EB%B3%B4%EC%97%AC%EC%A3%BC%EB%8A%94+%EA%B0%92%EA%B3%BC+%EA%B0%99%EC%8A%B5%EB%8B%88%EB%8B%A4.+%EC%83%81%ED%83%9C%EA%B0%92+%ED%91%9C%EB%8A%94+%5B%EB%B0%B0%EC%86%A1+API+%EC%8B%9C%EC%9E%91%ED%95%98%EA%B8%B0%5D%28%2Freference%2Fglobal-ship%2Fshipping-guide%29%EC%97%90+%EC%9E%88%EC%8A%B5%EB%8B%88%EB%8B%A4.%0A%0A%EC%9A%B4%EC%86%A1\u0026amp;theme=e6a2355564195c95220ac19a\u0026amp;signature=c60e065ee4674f5bddd9f0bcecf9be52f63916dbd084b39290f67ddff70d24c7\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"배송 정보 조회 - 딜리버드 파트너스 개발자 센터\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"DK 입고 송장번호로 배송 상태와 트래킹 정보를 조회합니다. 배송 상태(shipmentStatus)는 9종이며 DK 트래킹 페이지가 보여주는 값과 같습니다. 상태값 표는 배송 API 시작하기에 있습니다. 운송사(carrier)는 송장 발행 전에도 반환됩니다. 트래킹 이벤트(trackingEvents)는 라스트 마일 송장이 아직 발행되지 않았거나 트래킹 조회에 실패하면 빈 배열([]) 이 되며, 필드 자체가 생략되지는 않습니다. 트래킹 조회에 실패해도 응답은 200이고 배송 상태는 정상 반환됩니다. 웹훅을 제공하지 않습니다. 폴링 방식으로 주기 호출하는 것을 전제로 합니다.자세한 호출 순서와 식별자 흐름은 배송 API 시작하기를 참고하세요. 인증은 API 키 · 환경 문서를 따릅니다.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://deliveredkorea.mintlify.site/_mintlify/api/og/v2?division=%EB%B0%B0%EC%86%A1+API\u0026amp;title=%EB%B0%B0%EC%86%A1+%EC%A0%95%EB%B3%B4+%EC%A1%B0%ED%9A%8C\u0026amp;description=DK+%EC%9E%85%EA%B3%A0+%EC%86%A1%EC%9E%A5%EB%B2%88%ED%98%B8%EB%A1%9C+%EB%B0%B0%EC%86%A1+%EC%83%81%ED%83%9C%EC%99%80+%ED%8A%B8%EB%9E%98%ED%82%B9+%EC%A0%95%EB%B3%B4%EB%A5%BC+%EC%A1%B0%ED%9A%8C%ED%95%A9%EB%8B%88%EB%8B%A4.+%EB%B0%B0%EC%86%A1+%EC%83%81%ED%83%9C%28%60shipmentStatus%60%29%EB%8A%94+9%EC%A2%85%EC%9D%B4%EB%A9%B0+DK+%ED%8A%B8%EB%9E%98%ED%82%B9+%ED%8E%98%EC%9D%B4%EC%A7%80%EA%B0%80+%EB%B3%B4%EC%97%AC%EC%A3%BC%EB%8A%94+%EA%B0%92%EA%B3%BC+%EA%B0%99%EC%8A%B5%EB%8B%88%EB%8B%A4.+%EC%83%81%ED%83%9C%EA%B0%92+%ED%91%9C%EB%8A%94+%5B%EB%B0%B0%EC%86%A1+API+%EC%8B%9C%EC%9E%91%ED%95%98%EA%B8%B0%5D%28%2Freference%2Fglobal-ship%2Fshipping-guide%29%EC%97%90+%EC%9E%88%EC%8A%B5%EB%8B%88%EB%8B%A4.%0A%0A%EC%9A%B4%EC%86%A1\u0026amp;theme=e6a2355564195c95220ac19a\u0026amp;signature=c60e065ee4674f5bddd9f0bcecf9be52f63916dbd084b39290f67ddff70d24c7\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/deliveredkorea/T0pW9gCUVcpB_AaO/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"딜리버드 파트너스 개발자 센터\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#FF9123\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developers-partners.delivered.co.kr/reference/global-ship/api/get-shipment-tracking\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/reference/global-ship/api/get-shipment-tracking.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developers-partners.delivered.co.kr/#organization\",\"name\":\"딜리버드 파트너스 개발자 센터\",\"url\":\"https://developers-partners.delivered.co.kr\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/deliveredkorea/nWJ7e83AaZRK5B9H/logo/light.svg?fit=max\u0026auto=format\u0026n=nWJ7e83AaZRK5B9H\u0026q=85\u0026s=8ca84e82637f7edb2b349181a5b3a2af\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developers-partners.delivered.co.kr#website\",\"name\":\"딜리버드 파트너스 개발자 센터\",\"url\":\"https://developers-partners.delivered.co.kr\",\"publisher\":{\"@id\":\"https://developers-partners.delivered.co.kr/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developers-partners.delivered.co.kr/reference/global-ship/api/get-shipment-tracking#webpage\",\"url\":\"https://developers-partners.delivered.co.kr/reference/global-ship/api/get-shipment-tracking\",\"name\":\"배송 정보 조회\",\"description\":\"DK 입고 송장번호로 배송 상태와 트래킹 정보를 조회합니다. 배송 상태(shipmentStatus)는 9종이며 DK 트래킹 페이지가 보여주는 값과 같습니다. 상태값 표는 배송 API 시작하기에 있습니다. 운송사(carrier)는 송장 발행 전에도 반환됩니다. 트래킹 이벤트(trackingEvents)는 라스트 마일 송장이 아직 발행되지 않았거나 트래킹 조회에 실패하면 빈 배열([]) 이 되며, 필드 자체가 생략되지는 않습니다. 트래킹 조회에 실패해도 응답은 200이고 배송 상태는 정상 반환됩니다. 웹훅을 제공하지 않습니다. 폴링 방식으로 주기 호출하는 것을 전제로 합니다.자세한 호출 순서와 식별자 흐름은 배송 API 시작하기를 참고하세요. 인증은 API 키 · 환경 문서를 따릅니다.\",\"dateModified\":\"2026-09-23T00:53:14.177Z\",\"isPartOf\":{\"@id\":\"https://developers-partners.delivered.co.kr#website\"},\"breadcrumb\":{\"@id\":\"https://developers-partners.delivered.co.kr/reference/global-ship/api/get-shipment-tracking#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developers-partners.delivered.co.kr/reference/global-ship/api/get-shipment-tracking#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"글로벌쉽\",\"item\":\"https://developers-partners.delivered.co.kr/reference/global-ship/api/validate-orders\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"배송 API\",\"item\":\"https://developers-partners.delivered.co.kr/reference/global-ship/shipping-guide\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"배송 정보 조회\",\"item\":\"https://developers-partners.delivered.co.kr/reference/global-ship/api/get-shipment-tracking\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://developers-partners.delivered.co.kr/reference/global-ship/api/get-shipment-tracking#apireference\",\"headline\":\"배송 정보 조회\",\"name\":\"배송 정보 조회\",\"description\":\"DK 입고 송장번호로 배송 상태와 트래킹 정보를 조회합니다. 배송 상태(shipmentStatus)는 9종이며 DK 트래킹 페이지가 보여주는 값과 같습니다. 상태값 표는 배송 API 시작하기에 있습니다. 운송사(carrier)는 송장 발행 전에도 반환됩니다. 트래킹 이벤트(trackingEvents)는 라스트 마일 송장이 아직 발행되지 않았거나 트래킹 조회에 실패하면 빈 배열([]) 이 되며, 필드 자체가 생략되지는 않습니다. 트래킹 조회에 실패해도 응답은 200이고 배송 상태는 정상 반환됩니다. 웹훅을 제공하지 않습니다. 폴링 방식으로 주기 호출하는 것을 전제로 합니다.자세한 호출 순서와 식별자 흐름은 배송 API 시작하기를 참고하세요. 인증은 API 키 · 환경 문서를 따릅니다.\",\"url\":\"https://developers-partners.delivered.co.kr/reference/global-ship/api/get-shipment-tracking\",\"mainEntityOfPage\":{\"@id\":\"https://developers-partners.delivered.co.kr/reference/global-ship/api/get-shipment-tracking#webpage\"},\"dateModified\":\"2026-09-23T00:53:14.177Z\",\"publisher\":{\"@id\":\"https://developers-partners.delivered.co.kr/#organization\"},\"isPartOf\":{\"@id\":\"https://developers-partners.delivered.co.kr#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"딜리버드 파트너스 개발자 센터\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"딜리버드 파트너스 개발자 센터","nav":{"global":null,"tabs":[{"tab":"가이드","pages":[{"title":"가이드","href":"/guide/global-checkout/introduction"}]},{"tab":"API \u0026 SDK","groups":[{"group":"업데이트 내역","pages":[{"title":"글로벌체크아웃 패치 노트","href":"/reference/changelog/go-update"},{"title":"글로벌링크 패치 노트","href":"/reference/changelog/gl-update"}]},{"group":"OPEN API 이용 안내","pages":[{"title":"API 키","href":"/reference/using-api/api-keys"},{"title":"환경","href":"/reference/using-api/environment"},{"title":"요청 및 응답","href":"/reference/using-api/req-res"}]},{"group":"글로벌체크아웃","pages":[{"title":"SDK 연동하기","href":"/reference/global-checkout/connecting"},{"group":"환율 API","pages":[{"title":"환율 정보 조회","openapi":"api-reference/global-checkout-api.json GET /open-api/v1/currencies/latest","href":"/reference/global-checkout/api/latest"}]},{"group":"주문 API","pages":[{"title":"주문 정보 조회","openapi":"api-reference/global-checkout-api.json GET /open-api/v1/orders","href":"/reference/global-checkout/api/orders"}]}]},{"group":"글로벌쉽","pages":[{"group":"주문 API","pages":[{"title":"주문 유효성 검사","openapi":"api-reference/global-ship-api.json POST /open-api/v1/orders/validators","href":"/reference/global-ship/api/validate-orders"},{"title":"주문 등록","openapi":"api-reference/global-ship-api.json POST /open-api/v1/orders","href":"/reference/global-ship/api/create-orders"}]},{"group":"주문 API (LOTOS)","pages":[{"title":"주문 유효성 검사","openapi":"api-reference/global-ship-api.json POST /open-api/v1/orders/lotos/validators","href":"/reference/global-ship/api/validate-lotos-orders"},{"title":"주문 등록","openapi":"api-reference/global-ship-api.json POST /open-api/v1/orders/lotos","href":"/reference/global-ship/api/create-lotos-orders"}]},{"group":"배송 API","pages":[{"title":"배송 API 시작하기","href":"/reference/global-ship/shipping-guide"},{"title":"배송 신청","openapi":"api-reference/global-ship-api.json POST /open-api/v1/shipments","href":"/reference/global-ship/api/create-shipments"},{"title":"라벨 발행 (다건)","openapi":"api-reference/global-ship-api.json POST /open-api/v1/shipments/labels","href":"/reference/global-ship/api/create-shipment-labels"},{"title":"라벨 발행 (단건)","openapi":"api-reference/global-ship-api.json GET /open-api/v1/shipments/{masterNumber}/label","description":"DK 입고 송장번호 **한 건**으로 라벨 PDF를 반환합니다. 응답은 `application/pdf` 바이너리입니다.\n\n라벨이 아직 없는 배송 건은 이 호출에서 발행하고, 이미 발행된 건은 저장된 라벨을 그대로 사용합니다. 동작은 [라벨 발행 (다건)](/reference/global-ship/api/create-shipment-labels) API와 같고 **건수만 다릅니다**.\n\n\u003cWarning>존재하지 않는 송장번호이거나 다른 고객사의 배송 건이면 PDF가 반환되지 않고 404 · 403으로 거부됩니다.\u003c/Warning>\n\n여러 건을 한 번에 받으려면 라벨 발행 (다건) API를 사용하세요. 이 API는 **재출력**이나 **다건 발행 중 일부 실패 건을 개별 복구**할 때 사용합니다.\n\n자세한 호출 순서와 식별자 흐름은 [배송 API 시작하기](/reference/global-ship/shipping-guide)를 참고하세요. 인증은 [API 키](/reference/using-api/api-keys) · [환경](/reference/using-api/environment) 문서를 따릅니다.","href":"/reference/global-ship/api/get-shipment-label"},{"title":"배송 정보 조회","openapi":"api-reference/global-ship-api.json GET /open-api/v1/shipments/{masterNumber}/tracking","href":"/reference/global-ship/api/get-shipment-tracking"}]}]},{"group":"글로벌링크","pages":[{"group":"상품 API","pages":[{"title":"상품 등록","openapi":"api-reference/global-link-api.json POST /open-api/v1/global-link/products","description":"\n 상품 등록 API 입니다.\n 상품을 Bulk로 등록합니다. 1회 요청 시 최대 100건까지 처리합니다.\n\n 응답은 부분 성공 모델입니다.\n - successCount: 등록 성공한 상품 수\n - failureCount: 실패한 상품 수\n - failures[]: 실패한 상품별 상세 (shopProductId, errorCode, message)\n 실패가 있어도 HTTP 200으로 응답하므로, 클라이언트는 failures[]를 반드시 확인해야 합니다.\n ","href":"/reference/global-ship/api/create-products"},{"title":"상품 정보 수정","openapi":"api-reference/global-link-api.json PUT /open-api/v1/global-link/products/{shopProductId}","href":"/reference/global-ship/api/update-product"},{"title":"상품 재고 수정","openapi":"api-reference/global-link-api.json POST /open-api/v1/global-link/products/stock-updates","href":"/reference/global-ship/api/update-stock"},{"title":"상품 정보 삭제","openapi":"api-reference/global-link-api.json DELETE /open-api/v1/global-link/products/{shopProductId}","href":"/reference/global-ship/api/delete-product"}]}]}]}]},"basePath":"","title":"배송 정보 조회 - 딜리버드 파트너스 개발자 센터","buildId":"dpl_8LJbrAiZvr1K98WQNZXCyY5AvT34","deploymentId":"dpl_8LJbrAiZvr1K98WQNZXCyY5AvT34","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-i2a3QZ8E.js","utils-ChLwp8m0.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DRktVTDc.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CA2pEs4T.js","snippetPresets-ClQ6XrKD.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-Ct_Lv36y.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-Cn2PYw9e.js","shallow-rkyymjXQ.js","getApiPlaygroundDisplay-BB9vkXtE.js","CodeSnippet-Bm5RU7m1.js","CodeSnippets-BgU9Deuz.js","Page-BUDYNlhG.js","getPastedJson-BD-6NNum.js","icon-8Z6tud2e.js","MethodPill-Tuzr4g3V.js","DuplicateIcon-0ceWFYhN.js","createIcon-FBXow_ST.js","DynamicMarkdown-CD8713Yy.js","SectionHeading-7zgzQbH-.js","axios-vUo_bRtp.js","Markdown-D7Ofw1oz.js","clsx-eKJ4rcii.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CwjSCXIK.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-9EK5IAXV.js"]}