하나 이상의 Booking Number를 등록하여 화물 추적을 시작합니다.
\nRequest는 Array 형태로 구성해야 합니다.
\n각 추적 데이터는 booking_no + carrier_code + reference_no 조합으로 고유하게 식별되며, 이 식별자는 모든 부킹번호 트래킹 API에서 공통으로 사용됩니다.
reference_no는 고객의 내부 화물 식별자입니다. (예: Purchase Order 번호, House No. 등)
한 번의 요청으로 최대 50건까지 등록할 수 있습니다.
\n지원하는 선사 코드는 추적 가능한 선사 목록을 참고해 주세요.
\n하나 이상의 부킹번호에 대한 상세 추적 정보를 조회합니다.
\n추적 상태가 PROCESSING이 된 이후부터 상세 추적 정보를 조회할 수 있습니다.
한 번에 최대 50개의 부킹번호를 조회할 수 있습니다.
\ncontent 내 날짜 및 시간 필드는 ISO 8601 형식(yyyy-MM-dd'T'HH:mm:ssXXX)으로 제공됩니다.
Booking number
\n","type":"text/plain"},"key":"booking_no","value":"[Booking No]"},{"description":{"content":"Registration Start Date (ISO 8601 date/time format: yyyy-MM-dd'T'HH:mm:ssXXX)
\n","type":"text/plain"},"key":"register_from","value":"[Register From]"},{"description":{"content":"Registration End Date (ISO 8601 date/time format: yyyy-MM-dd'T'HH:mm:ssXXX)
\n","type":"text/plain"},"key":"register_to","value":"[Register To]"},{"description":{"content":"Reference number
\n","type":"text/plain"},"key":"reference_no","value":"[Reference No]"},{"description":{"content":"Carrier code
\n","type":"text/plain"},"key":"carrier_code","value":"[Carrier Code]"},{"description":{"content":"(required) Page number (minimum: 1)
\n","type":"text/plain"},"key":"page","value":"[Page]"},{"description":{"content":"(required) Page size (range: 1-50)
\n","type":"text/plain"},"key":"size","value":"[Size]"},{"disabled":true,"description":{"content":"tracking status
\n","type":"text/plain"},"key":"status","value":""}],"variable":[]}},"response":[{"id":"45578875-74bb-4aa9-bb42-129c97ca8696","name":"200 OK","originalRequest":{"method":"GET","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"url":{"raw":"https://api.tradlinx.com/partners/track/v3/booking-tracks?booking_no=[Booking No]®ister_from=[Register From]®ister_to=[Register To]&reference_no=[Reference No]&carrier_code=[Carrier Code]&page=[Page]&size=[Size]","host":["https://api.tradlinx.com"],"path":["partners","track","v3","booking-tracks"],"query":[{"key":"booking_no","value":"[Booking No]","description":"Booking number"},{"key":"register_from","value":"[Register From]","description":"Registration Start Date (ISO 8601 date/time format: yyyy-MM-dd'T'HH:mm:ssXXX)"},{"key":"register_to","value":"[Register To]","description":"Registration End Date (ISO 8601 date/time format: yyyy-MM-dd'T'HH:mm:ssXXX)"},{"key":"reference_no","value":"[Reference No]","description":"Reference number"},{"key":"carrier_code","value":"[Carrier Code]","description":"Carrier code"},{"key":"page","value":"[Page]","description":"(required) Page number (minimum: 1)"},{"key":"size","value":"[Size]","description":"(required) Page size (range: 1-50)"},{"key":"status","value":"","description":"tracking status","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"api_version\": \"v3\",\n \"content\": [\n {\n \"bl_nos\": [\n \"SAMPLE_BL_NOS\"\n ],\n \"booking_no\": \"SAMPLE_BOOKING_NO\",\n \"carrier_code\": \"SAMPLE_CARRIER_CODE\",\n \"client\": \"SAMPLE_CLIENT\",\n \"container_movement_enabled\": false,\n \"containers\": [\n {\n \"cntr_no\": \"SAMPLE_CNTR_NO\",\n \"cntr_sz\": \"SAMPLE_CNTR_SZ\",\n \"cntr_tp\": \"SAMPLE_CNTR_TP\",\n \"container_events\": [\n {\n \"event_datetime\": \"SAMPLE_EVENT_DATETIME\",\n \"event_type\": \"SAMPLE_EVENT_TYPE\",\n \"is_actual\": false,\n \"port_code\": \"SAMPLE_PORT_CODE\",\n \"transportation\": \"SAMPLE_TRANSPORTATION\"\n }\n ],\n \"seal_no\": \"SAMPLE_SEAL_NO\"\n }\n ],\n \"current_vessel\": {\n \"imo\": \"SAMPLE_IMO\",\n \"mmsi\": \"SAMPLE_MMSI\",\n \"vessel_name\": \"SAMPLE_VESSEL_NAME\",\n \"voyage\": \"SAMPLE_VOYAGE\"\n },\n \"detail_status\": \"SAMPLE_DETAIL_STATUS\",\n \"internal_usage\": \"SAMPLE_INTERNAL_USAGE\",\n \"origin\": {\n \"location_code\": \"SAMPLE_LOCATION_CODE\",\n \"location_name\": \"SAMPLE_LOCATION_NAME\",\n \"init_date_time\": \"2025-07-08T07:25:39+09:00\",\n \"estimate_date_time\": \"2025-07-08T07:25:39+09:00\",\n \"actual_date_time\": \"2025-07-08T07:25:39+09:00\"\n },\n \"pod\": {\n \"ata\": \"2025-07-09T05:32:47+09:00\",\n \"eta\": \"2025-07-09T05:32:47+09:00\",\n \"init_eta\": \"2025-07-09T05:32:47+09:00\",\n \"pod_code\": \"SAMPLE_POD_CODE\",\n \"pod_name\": \"SAMPLE_POD_NAME\",\n \"tx_ata\": \"2025-07-09T05:32:47+09:00\"\n },\n \"pol\": {\n \"atd\": \"2025-07-09T05:32:47+09:00\",\n \"etd\": \"2025-07-09T05:32:47+09:00\",\n \"init_etd\": \"2025-07-09T05:32:47+09:00\",\n \"pol_code\": \"SAMPLE_POL_CODE\",\n \"pol_name\": \"SAMPLE_POL_NAME\",\n \"tx_atd\": \"2025-07-09T05:32:47+09:00\"\n },\n \"destination\": {\n \"location_code\": \"SAMPLE_LOCATION_CODE\",\n \"location_name\": \"SAMPLE_LOCATION_NAME\",\n \"init_date_time\": \"2025-07-08T07:25:39+09:00\",\n \"estimate_date_time\": \"2025-07-08T07:25:39+09:00\",\n \"actual_date_time\": \"2025-07-08T07:25:39+09:00\"\n },\n \"reference_no\": \"SAMPLE_REFERENCE_NO\",\n \"registered_datetime\": \"2025-07-08T07:25:39.493Z\",\n \"remark\": \"SAMPLE_REMARK\",\n \"routes\": [\n {\n \"ata\": \"2025-07-09T05:32:47+09:00\",\n \"atd\": \"2025-07-09T05:32:47+09:00\",\n \"eta\": \"2025-07-09T05:32:47+09:00\",\n \"etd\": \"2025-07-09T05:32:47+09:00\",\n \"imo\": \"SAMPLE_IMO\",\n \"init_eta\": \"2025-07-09T05:32:47+09:00\",\n \"init_etd\": \"2025-07-09T05:32:47+09:00\",\n \"mmsi\": \"SAMPLE_MMSI\",\n \"order\": 0,\n \"pod_code\": \"SAMPLE_POD_CODE\",\n \"pod_name\": \"SAMPLE_POD_NAME\",\n \"pol_code\": \"SAMPLE_POL_CODE\",\n \"pol_name\": \"SAMPLE_POL_NAME\",\n \"tx_ata\": \"2025-07-09T05:32:47+09:00\",\n \"tx_atd\": \"2025-07-09T05:32:47+09:00\",\n \"vessel_name\": \"SAMPLE_VESSEL_NAME\",\n \"voyage\": \"SAMPLE_VOYAGE\"\n }\n ],\n \"status\": \"SAMPLE_STATUS\",\n \"track_mst_id\": \"SAMPLE_TRACK_MST_ID\",\n \"trans_type\": \"SAMPLE_TRANS_TYPE\"\n }\n ],\n \"message\": \"SAMPLE_ERROR_CODE\",\n \"pagination\": {\n \"current_page\": 0,\n \"has_next\": false,\n \"total_page\": 0,\n \"total_size\": 0\n },\n \"size\": 1,\n \"transaction_time\": \"2025-07-09T05:32:47.939106\"\n}"},{"id":"bc15938b-d8c5-4594-982b-20424a18dd99","name":"400 Error","originalRequest":{"method":"GET","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"url":{"raw":"https://api.tradlinx.com/partners/track/v3/booking-tracks?booking_no=[Booking No]®ister_from=[Register From]®ister_to=[Register To]&reference_no=[Reference No]&carrier_code=[Carrier Code]&page=[Page]&size=[Size]","host":["https://api.tradlinx.com"],"path":["partners","track","v3","booking-tracks"],"query":[{"key":"booking_no","value":"[Booking No]","description":"Booking number"},{"key":"register_from","value":"[Register From]","description":"Registration Start Date (ISO 8601 date/time format: yyyy-MM-dd'T'HH:mm:ssXXX)"},{"key":"register_to","value":"[Register To]","description":"Registration End Date (ISO 8601 date/time format: yyyy-MM-dd'T'HH:mm:ssXXX)"},{"key":"reference_no","value":"[Reference No]","description":"Reference number"},{"key":"carrier_code","value":"[Carrier Code]","description":"Carrier code"},{"key":"page","value":"[Page]","description":"(required) Page number (minimum: 1)"},{"key":"size","value":"[Size]","description":"(required) Page size (range: 1-50)"},{"key":"status","value":"","description":"tracking status","disabled":true}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"error_detail\": \"[page]: The value of the field must be greater than or equal to 1.\",\n \"message\": \"SAMPLE_ERROR_CODE\",\n \"transaction_time\": \"2025-03-20T05:42:27.171506\"\n}"},{"id":"41491ea6-3446-4782-96d6-715349baec65","name":"500 Error","originalRequest":{"method":"GET","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"url":{"raw":"https://api.tradlinx.com/partners/track/v3/booking-tracks?booking_no=[Booking No]®ister_from=[Register From]®ister_to=[Register To]&reference_no=[Reference No]&carrier_code=[Carrier Code]&page=[Page]&size=[Size]","host":["https://api.tradlinx.com"],"path":["partners","track","v3","booking-tracks"],"query":[{"key":"booking_no","value":"[Booking No]","description":"Booking number"},{"key":"register_from","value":"[Register From]","description":"Registration Start Date (ISO 8601 date/time format: yyyy-MM-dd'T'HH:mm:ssXXX)"},{"key":"register_to","value":"[Register To]","description":"Registration End Date (ISO 8601 date/time format: yyyy-MM-dd'T'HH:mm:ssXXX)"},{"key":"reference_no","value":"[Reference No]","description":"Reference number"},{"key":"carrier_code","value":"[Carrier Code]","description":"Carrier code"},{"key":"page","value":"[Page]","description":"(required) Page number (minimum: 1)"},{"key":"size","value":"[Size]","description":"(required) Page size (range: 1-50)"},{"key":"status","value":"","description":"tracking status","disabled":true}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"status\": 500,\n\t\"type\": \"Internal Server Error\",\n\t\"message\": \"Internal server error. Please try again in a few minutes.\"\n}"}],"_postman_id":"583c9654-ef12-4b56-a200-38d69d7e04c8"},{"name":"3. 부킹번호 하위 컨테이너 정보 조회 변경 요청","id":"12d69d88-5ea0-4b4d-863d-8c844620db99","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"enabled\": true\n }","options":{"raw":{"language":"json"}}},"url":"https://api.tradlinx.com/partners/track/v3/booking-tracks/:track_mst_id/container-movement","description":"부킹번호 트래킹 데이터의 컨테이너 단위 추적 기능을 활성화하거나 비활성화합니다.
\n한 번에 하나의 데이터만 요청할 수 있습니다.
\n이미 컨테이너 단위 추적이 활성화되어 Credit이 차감된 경우에는 해당 설정을 변경할 수 없습니다.
\nUnique shipment ID that can be obtained through shipment lookup
\n","type":"text/plain"},"type":"any","value":"","key":"track_mst_id"}]}},"response":[{"id":"6352705d-52ce-43cf-a76e-4f0c2f62e4cd","name":"200 OK","originalRequest":{"method":"POST","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"enabled\": true\n }","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.tradlinx.com/partners/track/v3/booking-tracks/:track_mst_id/container-movement","host":["https://api.tradlinx.com"],"path":["partners","track","v3","booking-tracks",":track_mst_id","container-movement"],"variable":[{"key":"track_mst_id","value":"","description":"Unique shipment ID that can be obtained through shipment lookup"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"api_version\": \"v3\",\n \"content\": {\n \"enabled\": true,\n \"track_mst_id\": \"SAMPLE_TRACK_MST_ID\"\n },\n \"message\": \"SAMPLE_ERROR_CODE\",\n \"transaction_time\": \"2025-07-09T05:14:29.153253\"\n}"}],"_postman_id":"12d69d88-5ea0-4b4d-863d-8c844620db99"},{"name":"4. 부킹번호 트래킹 수정 요청","id":"f49c1645-80b5-4d55-98f3-6d9335ed45fe","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"reference_no\": \"SAMPLE_REFERENCE_NO\",\n \"client\": \"SAMPLE_CLIENT_NAME\",\n \"internal_usage\": \"SAMPLE_INTERNAL_USAGE\",\n \"remark\": \"SAMPLE_REMARK\"\n }","options":{"raw":{"language":"json"}}},"url":"https://api.tradlinx.com/partners/track/v3/booking-tracks/:track_mst_id","description":"기존 부킹번호 트래킹 데이터의 메타데이터를 수정합니다.
\nbooking_no + carrier_code + reference_no 조합은 고유하게 유지되어야 합니다.
수정 후 동일한 식별자 조합을 가진 추적 데이터가 생성되는 경우 수정이 거부됩니다.
\nUnique shipment ID that can be obtained through shipment lookup
\n","type":"text/plain"},"type":"any","value":"","key":"track_mst_id"}]}},"response":[{"id":"0eeb6c68-d8c2-4599-a82c-6c89823fdc25","name":"200 OK","originalRequest":{"method":"PUT","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"reference_no\": \"SAMPLE_REFERENCE_NO\",\n \"client\": \"SAMPLE_CLIENT_NAME\",\n \"internal_usage\": \"SAMPLE_INTERNAL_USAGE\",\n \"remark\": \"SAMPLE_REMARK\"\n }","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.tradlinx.com/partners/track/v3/booking-tracks/:track_mst_id","host":["https://api.tradlinx.com"],"path":["partners","track","v3","booking-tracks",":track_mst_id"],"variable":[{"key":"track_mst_id","value":"","description":"Unique shipment ID that can be obtained through shipment lookup"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{}"},{"id":"378f5972-2c61-40a6-a64c-7a6baf0daad3","name":"400 Error","originalRequest":{"method":"PUT","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"reference_no\": \"SAMPLE_REFERENCE_NO\",\n \"client\": \"SAMPLE_CLIENT_NAME\",\n \"internal_usage\": \"SAMPLE_INTERNAL_USAGE\",\n \"remark\": \"SAMPLE_REMARK\"\n }","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.tradlinx.com/partners/track/v3/booking-tracks/:track_mst_id","host":["https://api.tradlinx.com"],"path":["partners","track","v3","booking-tracks",":track_mst_id"],"variable":[{"key":"track_mst_id","value":"","description":"Unique shipment ID that can be obtained through shipment lookup"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"error_detail\": \"[track_mst_id]: must not be blank\",\n \"message\": \"SAMPLE_ERROR_CODE\",\n \"transaction_time\": \"2024-08-13T05:42:27.402256\"\n}"}],"_postman_id":"f49c1645-80b5-4d55-98f3-6d9335ed45fe"},{"name":"5. 부킹번호 트래킹 취소 요청","id":"674dcb2e-f90f-4070-82c2-58d623c8b94f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"url":"https://api.tradlinx.com/partners/track/v3/booking-tracks/:track_mst_id","description":"기존 부킹번호 트래킹 데이터를 취소합니다.
\n취소는 한 번에 하나의 데이터만 요청할 수 있습니다.
\n추적이 시작되기 전까지만 Credit이 환불됩니다. 추적 상태가 TRACKING 또는 COMPLETE인 경우에는 Credit이 환불되지 않습니다.
Unique shipment ID that can be obtained through shipment lookup
\n","type":"text/plain"},"type":"any","value":"","key":"track_mst_id"}]}},"response":[{"id":"e224efdd-ab09-4d30-9924-bf02b2c1028d","name":"200 OK","originalRequest":{"method":"DELETE","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"url":{"raw":"https://api.tradlinx.com/partners/track/v3/booking-tracks/:track_mst_id","host":["https://api.tradlinx.com"],"path":["partners","track","v3","booking-tracks",":track_mst_id"],"variable":[{"key":"track_mst_id","value":"","description":"Unique shipment ID that can be obtained through shipment lookup"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"api_version\": \"v3\",\n \"transaction_time\": \"2026-06-25T04:24:25.257102\"\n}"},{"id":"50624485-b02d-4da1-9084-89d8b3fc9c31","name":"500 Error","originalRequest":{"method":"DELETE","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"url":{"raw":"https://api.tradlinx.com/partners/track/v3/booking-tracks/:track_mst_id","host":["https://api.tradlinx.com"],"path":["partners","track","v3","booking-tracks",":track_mst_id"],"variable":[{"key":"track_mst_id","value":"","description":"Unique shipment ID that can be obtained through shipment lookup"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"error_detail\": \"UNKOWN ERROR\",\n \"transaction_time\": \"2026-06-25 04:27:34\",\n \"message\": \"UNKNOWN\"\n}"}],"_postman_id":"674dcb2e-f90f-4070-82c2-58d623c8b94f"},{"name":"6. 부킹번호 트래킹 재등록 요청","id":"48faebc7-1b32-4c75-87fa-efa9cbed8f94","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{}","options":{"raw":{"language":"json"}}},"url":"https://api.tradlinx.com/partners/track/v3/booking-tracks/:track_mst_id/re-enroll","description":"Unique shipment ID that can be obtained through shipment lookup
\n","type":"text/plain"},"type":"any","value":"","key":"track_mst_id"}]}},"response":[{"id":"afa4bd70-c25c-42d9-9b9d-c7bfe6016187","name":"200 OK","originalRequest":{"method":"POST","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.tradlinx.com/partners/track/v3/booking-tracks/:track_mst_id/re-enroll","host":["https://api.tradlinx.com"],"path":["partners","track","v3","booking-tracks",":track_mst_id","re-enroll"],"variable":[{"key":"track_mst_id","value":"","description":"Unique shipment ID that can be obtained through shipment lookup"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"api_version\": \"v3\",\n \"content\": {\n \"booking_no\": \"SAMPLE_BOOKING_NO\",\n \"carrier_code\": \"SAMPLE_CARRIER_CODE\",\n \"client\": \"SAMPLE_CLIENT\",\n \"container_movement_enabled\": true,\n \"internal_usage\": \"SAMPLE_INTERNAL_USAGE\",\n \"reference_no\": \"SAMPLE_REFERENCE_NO\",\n \"track_mst_id\": \"SAMPLE_TRACK_MST_ID\"\n },\n \"message\": \"SAMPLE_ERROR_CODE\",\n \"transaction_time\": \"2025-07-09T05:22:11.380245\"\n}"}],"_postman_id":"48faebc7-1b32-4c75-87fa-efa9cbed8f94"}],"id":"e270da10-173d-49ae-aed4-6a91ee48f1d7","description":"Tradlinx는 B/L, Booking No., Container, Vessel를 기준으로 화물 추적을 제공합니다. 이 페이지에서는 부킹 번호(Booking No.) 트래킹에 대해서만 설명합니다.
\n부킹 번호 트래킹은 Booking Number를 이용하여 화물의 운송 상태를 조회할 수 있는 API입니다. 부킹 번호와 선사 코드를 등록하면 Tradlinx가 화물 추적을 시작하고 API를 통해 최신 추적 정보를 제공합니다.
\n부킹 번호 트래킹 API 이용을 원하시는 경우 help@tradlinx.com 으로 메일 주시거나 담당 영업사원에게 요청해주세요.
\n처음 사용하는 경우 아래 두 단계만으로 화물 추적을 시작할 수 있습니다.
\n[Booking 등록하기 →]
\nBooking Number와 선사 코드를 등록하면 Tradlinx가 즉시 화물 추적을 시작합니다.
\n[추적 정보 조회하기 →]
\n동일한 식별자(Booking Number + Carrier Code + Reference No.)로 조회합니다. 상태가 TRACKING이 되면 화물 이벤트 및 추적 정보를 조회할 수 있습니다.
\n","_postman_id":"e270da10-173d-49ae-aed4-6a91ee48f1d7"},{"name":"AI-ETA > 부킹번호","item":[{"name":"1. 부킹번호 트래킹 데이터 상세 조회 (AI ETA 포함)","id":"57e11b29-54b6-43b1-8f4f-7bf52a71ef15","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"url":"https://api.tradlinx.com/partners/track/v3/booking-tracks/details/ai-eta?booking_no=[Booking No]®ister_from=[Register From]®ister_to=[Register To]&reference_no=[Reference No]&carrier_code=[Carrier Code]&page=[Page]&size=[Size]","description":"등록된 화물의 부킹번호 트래킹의 상세 정보와 AI ETA 예측 정보를 조회합니다.
\n이 API는 Booking No. 트래킹 API를 함께 사용해야 하며, 부킹번호 트래킹으로 등록된 화물에 대해서만 조회할 수 있습니다.
\nAI ETA 예측 정보를 조회하려면 기존 \"2. 부킹번호 트래킹 데이터 상세 조회\" API 대신 이 API를 사용하면 됩니다.
\n한 번의 요청으로 최대 50건의 Tracking 정보를 조회할 수 있습니다.
\n정상적으로 등록된 트래킹에 대해서만 상세 조회가 가능합니다.
\ncontent 내 날짜 및 시간 필드는 ISO 8601 형식(yyyy-MM-dd'T'HH:mm:ssXXX)으로 제공됩니다.
Booking number
\n","type":"text/plain"},"key":"booking_no","value":"[Booking No]"},{"description":{"content":"Registration Start Date (ISO 8601 date/time format: yyyy-MM-dd'T'HH:mm:ssXXX)
\n","type":"text/plain"},"key":"register_from","value":"[Register From]"},{"description":{"content":"Registration End Date (ISO 8601 date/time format: yyyy-MM-dd'T'HH:mm:ssXXX)
\n","type":"text/plain"},"key":"register_to","value":"[Register To]"},{"description":{"content":"Reference number
\n","type":"text/plain"},"key":"reference_no","value":"[Reference No]"},{"description":{"content":"Carrier code
\n","type":"text/plain"},"key":"carrier_code","value":"[Carrier Code]"},{"description":{"content":"(required) Page number (minimum: 1)
\n","type":"text/plain"},"key":"page","value":"[Page]"},{"description":{"content":"(required) Page size (range: 1-50)
\n","type":"text/plain"},"key":"size","value":"[Size]"},{"disabled":true,"description":{"content":"tracking status
\n","type":"text/plain"},"key":"status","value":""}],"variable":[]}},"response":[{"id":"ff6e9ce7-219e-422f-9ef4-5d3341f1184f","name":"200 OK","originalRequest":{"method":"GET","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"url":{"raw":"https://api.tradlinx.com/partners/track/v3/booking-tracks/details/ai-eta?booking_no=[Booking No]®ister_from=[Register From]®ister_to=[Register To]&reference_no=[Reference No]&carrier_code=[Carrier Code]&page=[Page]&size=[Size]","host":["https://api.tradlinx.com"],"path":["partners","track","v3","booking-tracks","details","ai-eta"],"query":[{"key":"booking_no","value":"[Booking No]","description":"Booking number"},{"key":"register_from","value":"[Register From]","description":"Registration Start Date (ISO 8601 date/time format: yyyy-MM-dd'T'HH:mm:ssXXX)"},{"key":"register_to","value":"[Register To]","description":"Registration End Date (ISO 8601 date/time format: yyyy-MM-dd'T'HH:mm:ssXXX)"},{"key":"reference_no","value":"[Reference No]","description":"Reference number"},{"key":"carrier_code","value":"[Carrier Code]","description":"Carrier code"},{"key":"page","value":"[Page]","description":"(required) Page number (minimum: 1)"},{"key":"size","value":"[Size]","description":"(required) Page size (range: 1-50)"},{"key":"status","value":"","description":"tracking status","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"api_version\": \"v3\",\n \"transaction_time\": \"2026-07-09T06:45:04.963440\",\n \"content\": [\n {\n \"track_mst_id\": \"SAMPLE_TRACK_MST_ID\",\n \"carrier_code\": \"SAMPLE_CARRIER_CODE\",\n \"booking_no\": \"SAMPLE_BOOKING_NO\",\n \"reference_no\": \"SAMPLE_REFERENCE_NO\",\n \"client\": \"SAMPLE_CLIENT\",\n \"internal_usage\": \"SAMPLE_INTERNAL_USAGE\",\n \"remark\": \"SAMPLE_REMARK\",\n \"registered_datetime\": \"2026-06-25T04:47:53Z\",\n \"status\": \"SAMPLE_STATUS\",\n \"detail_status\": \"SAMPLE_DETAIL_STATUS\",\n \"container_movement_enabled\": true,\n \"bl_nos\": [],\n \"trans_type\": \"SAMPLE_TRANS_TYPE\",\n \"origin\": {\n \"location_name\": \"\",\n \"location_code\": \"\",\n \"init_date_time\": null,\n \"estimate_date_time\": null,\n \"actual_date_time\": null\n },\n \"pol\": {\n \"pol_name\": \"SAMPLE_POL_NAME\",\n \"pol_code\": \"SAMPLE_POL_CODE\",\n \"init_etd\": \"2026-06-20T14:30:00+08:00\",\n \"etd\": \"2026-06-21T16:30:00+08:00\",\n \"atd\": \"2026-06-22T03:58:00+08:00\",\n \"tx_atd\": \"2026-06-22T04:05:59+08:00\"\n },\n \"pod\": {\n \"pod_name\": \"SAMPLE_POD_NAME\",\n \"pod_code\": \"SAMPLE_POD_CODE\",\n \"init_eta\": \"2026-07-15T13:00:00-03:00\",\n \"eta\": \"2026-07-17T16:00:00-03:00\",\n \"ata\": null,\n \"tx_ata\": null,\n \"ai_eta\": {\n \"ai_eta\": \"2026-07-18T17:58:44-03:00\",\n \"ai_eta_p10\": \"2026-07-16T16:32:19-03:00\",\n \"ai_eta_p90\": \"2026-07-24T18:55:12-03:00\",\n \"ai_eta_confidence\": 24.00\n }\n },\n \"destination\": {\n \"location_name\": \"SAMPLE_LOCATION_NAME\",\n \"location_code\": \"SAMPLE_LOCATION_CODE\",\n \"init_date_time\": null,\n \"estimate_date_time\": null,\n \"actual_date_time\": null\n },\n \"current_vessel\": {\n \"imo\": \"SAMPLE_IMO\",\n \"mmsi\": \"SAMPLE_MMSI\",\n \"vessel_name\": \"SAMPLE_VESSEL_NAME\",\n \"voyage\": \"SAMPLE_VOYAGE\"\n },\n \"routes\": [\n {\n \"order\": 1,\n \"pol_name\": \"SAMPLE_POL_NAME\",\n \"pol_code\": \"SAMPLE_POL_CODE\",\n \"pod_name\": \"SAMPLE_POD_NAME\",\n \"pod_code\": \"SAMPLE_POD_CODE\",\n \"imo\": \"SAMPLE_IMO\",\n \"mmsi\": \"SAMPLE_MMSI\",\n \"vessel_name\": \"SAMPLE_VESSEL_NAME\",\n \"voyage\": \"SAMPLE_VOYAGE\",\n \"init_etd\": \"2026-06-20T14:30:00+08:00\",\n \"etd\": \"2026-06-21T16:30:00+08:00\",\n \"atd\": \"2026-06-22T03:58:00+08:00\",\n \"tx_atd\": \"2026-06-22T04:05:59+08:00\",\n \"init_eta\": \"2026-07-15T13:00:00-03:00\",\n \"eta\": \"2026-07-17T16:00:00-03:00\",\n \"ata\": null,\n \"tx_ata\": null,\n \"ai_eta\": {\n \"ai_eta\": \"2026-07-18T17:58:44-03:00\",\n \"ai_eta_p10\": \"2026-07-16T16:32:19-03:00\",\n \"ai_eta_p90\": \"2026-07-24T18:55:12-03:00\",\n \"ai_eta_confidence\": 24.00\n }\n }\n ],\n \"containers\": [\n {\n \"cntr_no\": \"SAMPLE_CNTR_NO\",\n \"cntr_sz\": \"SAMPLE_CNTR_SZ\",\n \"cntr_tp\": \"SAMPLE_CNTR_TP\",\n \"seal_no\": null,\n \"container_events\": [\n {\n \"port_code\": \"SAMPLE_PORT_CODE\",\n \"event_type\": \"SAMPLE_EVENT_TYPE\",\n \"transportation\": \"SAMPLE_TRANSPORTATION\",\n \"is_actual\": true,\n \"event_datetime\": \"2026-06-16T12:26:00+08:00\"\n },\n {\n \"port_code\": \"SAMPLE_PORT_CODE\",\n \"event_type\": \"SAMPLE_EVENT_TYPE\",\n \"transportation\": \"SAMPLE_TRANSPORTATION\",\n \"is_actual\": true,\n \"event_datetime\": \"2026-06-17T07:44:00+08:00\"\n }\n ]\n }\n ]\n }\n ],\n \"size\": 1,\n \"pagination\": {\n \"total_size\": 1,\n \"total_page\": 1,\n \"current_page\": 1,\n \"has_next\": false\n }\n}"}],"_postman_id":"57e11b29-54b6-43b1-8f4f-7bf52a71ef15"}],"id":"37ac0e26-67a7-4bb7-aa97-041ee3854080","description":"✅ AI ETA — 개요
\nAI ETA는 선적 추적 API를 통해 등록된 화물에 대해 AI 기반 도착 예정 시간을 제공합니다.
\n실시간 선박 데이터와 과거 운항 이력을 기반으로 선박의 도착 시간을 예측하며, 단일 ETA가 아닌 여러 도착 시나리오를 제공합니다.
\nAI ETA는 선박 지연, 항만 혼잡 및 운항 일정 변경으로 인해 발생하는 운영상의 불확실성에 대비할 수 있도록 지원합니다.
\nAI ETA는 단일 ETA 대신 확률 기반의 3가지 도착 시나리오를 제공합니다.
\nAI ETA는 확률 기반의 도착 예측 정보를 제공합니다.
\nP10과 P90 사이의 범위는 약 80% 신뢰구간(Confidence Interval) 을 의미하며, 낙관적·기준·보수적 도착 시나리오를 함께 검토할 수 있도록 지원합니다.
\nAI ETA는 해당 기능을 별도로 구독한 Ocean Visibility Enterprise Plan 고객에게만 제공되며, Shipment Tracking API를 함께 사용해야 합니다.
\n기능 이용을 원하시는 경우 help@tradlinx.com 으로 메일 주시거나 담당 영업사원에게 요청해주세요.
\n","_postman_id":"37ac0e26-67a7-4bb7-aa97-041ee3854080"},{"name":"추적 가능한 선사 목록","item":[],"id":"72577675-16fa-4afd-ad7c-8dd3f70d37b7","description":"Tradlinx Ocean Visibility는 전 세계 주요 해상 선사의 화물 추적을 지원합니다.
\n아래 표에서 선사별로 지원되는 추적 방식을 확인할 수 있습니다. (B/L Tracking, Container No. Tracking, Booking No. Tracking)
\n