加载接口文档…
查询运单的承运商、当前状态与轨迹明细。承运商编码可以省略，省略后由系统根据运单号识别。覆盖 2000 余家承运商。 按次计费。查询顺丰速运、中通快递时，须同时提交手机号码后 4 位。
由 极数本源 提供·更新于 今天
3.9万
累计调用
1602ms
平均响应
99.50%
服务可用性
本接口不提供公共免费额度。请按会员、按次或点数计费。
未携带 API Key
无匿名额度，须携带 API Key
登录免费
无登录免费额度 · QPS 10
黄金会员
本档不提供 VIP 额度 · QPS 10
钻石会员
本档不提供 VIP 额度 · QPS 30
企业会员
本档不提供 VIP 额度 · QPS 120
承运商编码可以省略。省略时，系统按运单号识别承运商。以 JD、JDV 开头的运单按京东物流查询。
必填 · 快递单号（8–40 位字母数字） · 示例：YT7460266600081
可选 · 可选公司编码；缺省由系统自动识别 · 示例：yto
可选 · 手机号后 4 位（顺丰 / 中通等场景可能需要） · 示例：1234
| 名称 | 类型 | 说明 |
|---|---|---|
| number（单号） | string | 必填 · 快递单号（8–40 位字母数字） · 示例：YT7460266600081 |
| com（快递公司） | string | 可选 · 可选公司编码；缺省由系统自动识别 · 示例：yto |
| phone（手机号） | string | 可选 · 手机号后 4 位（顺丰 / 中通等场景可能需要） · 示例：1234 |
必填 · 必填鉴权。推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。付费接口需携带有效 Key。
| 名称 | 类型 | 说明 |
|---|---|---|
| Authorization | string | 必填 · 必填鉴权。推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。付费接口需携带有效 Key。 |
单号
公司编码
公司中文名
状态码（如 EMPTY / TRANSIT / SIGNED）
状态说明
轨迹：time / content
时间
内容
品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn
| 名称 | 类型 | 说明 | ||||||
|---|---|---|---|---|---|---|---|---|
| number | string | 单号 | ||||||
| com | string | 公司编码 | ||||||
| com_name | string | 公司中文名 | ||||||
| status | string | 状态码（如 EMPTY / TRANSIT / SIGNED） | ||||||
| status_desc | string | 状态说明 | ||||||
| traces | array | 轨迹：time / content | ||||||
| ||||||||
| tips | string | 品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn | ||||||
{
"code": 0,
"msg": "成功",
"data": {
"number": "EA000123456CN:0000",
"com": "ems",
"com_name": "EMS",
"state": 3,
"status": "SIGNED",
"status_desc": "已签收",
"trace_count": 14,
"traces": [
{
"time": "2026-03-06 11:31:58",
"content": "您的快件已取走【示例市示例驿站A区1号店】，如有疑问请电联快递员【电话:13800138000】，揽投部【电话:0571-00000000】，投诉电话【电话:13900139000】。中国邮政服务热线11183。"
},
{
"time": "2026-03-03 17:29:26",
"content": "您的快件已派送至【示例市示例驿站A区1号店】，自提点电话:13700137000，请您凭取件码领取快件，如有疑问请电联快递员【电话:13800138000】，揽投部（电话0571-00000000），投诉电话（电话13900139000）。中国邮政服务热线11183。"
}
]
},
"tips": "极数本源 · https://apizero.cn",
"request_id": "req_demo_ems_0001"
}本接口数据由极数本源平台提供，仅供开发与测试参考。实际数据准确性、完整性与时效性以平台返回为准。