查询运单的承运商、当前状态与轨迹明细。承运商编码可以省略,省略后由系统根据运单号识别。覆盖 2000 余家承运商。 按次计费。查询顺丰速运、中通快递时,须同时提交手机号码后 4 位。
由 极数本源 提供·更新于 今天
3.9万
累计调用
1602ms
平均响应
99.50%
服务可用性
本接口不提供公共免费额度。请按会员、按次或点数计费。
未携带 API Key
无匿名额度,须携带 API Key
登录免费
无登录免费额度 · QPS 10
黄金会员
本档不提供 VIP 额度 · QPS 10
钻石会员
本档不提供 VIP 额度 · QPS 30
企业会员
本档不提供 VIP 额度 · QPS 120
承运商编码 yunda,查询韵达快递。
必填 · 快递单号(8–40 位字母数字) · 示例:YT7460266600081
可选 · 快递公司编码,此处固定 yunda · 默认 yunda · 示例:yunda
可选 · 手机号后 4 位(顺丰 / 中通等场景可能需要) · 示例:1234
| 名称 | 类型 | 说明 |
|---|---|---|
| number(单号) | string | 必填 · 快递单号(8–40 位字母数字) · 示例:YT7460266600081 |
| com(快递公司) | string | 可选 · 快递公司编码,此处固定 yunda · 默认 yunda · 示例:yunda |
| 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"
}本接口数据由极数本源平台提供,仅供开发与测试参考。实际数据准确性、完整性与时效性以平台返回为准。