Delhivery 快递应用数据 API：运单、金币、KYC

Delhivery Limited · 出行

Delhivery: Courier App 是德里弗里（Delhivery Limited）的消费者 Android 客户端。这家古尔冈上市的物流公司运营印度最大的独立包裹网络，覆盖公路、航空、同城 Local 与零担（PTL）货运。用户用手机号 OTP 登录后，可预订全国 Direct（C2C）取件、同城 Local 或零担，选择包裹尺寸与声明价值，可选 Delhivery Protect 保障，并通过 Razorpay 预付或货到付款；收件人一侧可跟踪运单、留下派送指示并提交支持工单。企业发件人在同一会话完成 GST 与 Aadhaar DigiLocker KYC，结账时使用 Delhivery Coins，并可套用学生优惠或推荐码。应用面向印度（深链挂在 delhivery.com），服务寄个人件的家庭、发订单的小卖家，以及等待电商入库的收件人，与 Blue Dart、DTDC、Shadowfax、Porter、印度邮政同一条赛道。

运单键 wbn、awb_number 与 promised_delivery_date 时间戳是登录后水合的货运记录脊柱——每行还带 tracking_status、scans 时间线以及取件/派送邮编。忠诚度落在并行账本里的 coins、expiring_coins 与 coins_redeemed；结账叠加 charged_weight_g、hl_freight 估价以及 Razorpay 的 hash 与 razorpay_order_id。

Aadhaar DigiLocker 与 GST 标志（aadhar_kyc_verified、gstin）为企业下单设门槛，这类订单往往需要 ewaybill。OMS 与退货工具可轮询跟踪，财务可把货到付款与金币核销对账，结账组件可在卖家承诺线路前预检 is_serviceable。openData Studio 把这些私有调用变成可调用的开放数据。

应用截图

API 端点一览

以下端点与请求/响应示例均依据应用界面推导重构，为示意说明，并非实际抓包。

请求登录 OTP

POST /v1/courier/auth/otp opendata

向 +91 手机号发送开启引导/登录界面的短信 OTP。

认证方式：无需登录。手机 OTP 开启会话；后续调用携带 Authorization: Bearer access_token 与 X-API-USER-INFO。

phone_number
country_code
device_id
otp_attempts
success
message

POST /v1/courier/auth/otp HTTP/1.1
Content-Type: application/json
X-API-REQID: 9f3a1c2e

{
  "phone_number": "9876543210",
  "country_code": "+91",
  "device_id": "android-3f8c"
}

{
  "success": true,
  "message": "OTP sent",
  "data": {
    "otp_attempts": 0,
    "phone_number": "9876543210",
    "country_code": "+91"
  }
}

用 OTP 换取客户访问令牌

POST /v1/courier/auth/session opendata

核验 OTP 并返回后续数据调用使用的客户会话（access_token、refresh_token、ucid）。

认证方式：刚在 POST /v1/courier/auth/otp 下发的 OTP。响应签发 access_token、refresh_token、session_token 与 ucid。

phone_number
otp
device_id
install_src
access_token
refresh_token
session_token
ucid
user_id
name

POST /v1/courier/auth/session HTTP/1.1
Content-Type: application/json

{
  "phone_number": "9876543210",
  "otp": "482913",
  "device_id": "android-3f8c",
  "install_src": "play"
}

{
  "success": true,
  "data": {
    "access_token": "<access_token>",
    "refresh_token": "<refresh_token>",
    "session_token": "<session_token>",
    "ucid": "U1234567890",
    "user_id": "9876543210",
    "name": "Anita Sharma"
  }
}

刷新会话令牌

POST /v1/auth/refresh opendata

在首页会话报告 JWT_TOKEN_EXPIRED / session_expired 时轮换 Bearer access_token。

认证方式：来自 POST /v1/courier/auth/session 的 refresh_token。响应轮换 access_token。

refresh_token
ucid
access_token
session_token

POST /v1/auth/refresh HTTP/1.1
Authorization: Bearer <access_token>
Content-Type: application/json
X-API-USER-INFO: U1234567890

{
  "refresh_token": "<refresh_token>",
  "ucid": "U1234567890"
}

{
  "success": true,
  "data": {
    "access_token": "<access_token>",
    "refresh_token": "<refresh_token>",
    "session_token": "<session_token>"
  }
}

统一运单跟踪

GET /v1/shipments/{wbn}/track opendata

水合运单跟踪界面：运单身份、当前 tracking_status、promised_delivery_date 与 scans 时间线。

认证方式： Bearer access_token 加 X-API-USER-INFO。公开 AWB 查询仍可用 wbn 参数。

wbn
waybill
awb_number
order_id
tracking_status
order_status
promised_delivery_date
location
origin_city
destination_city
o_pincode
d_pincode
scans
status

GET /v1/shipments/{wbn}/track?wbn=1234567890123 HTTP/1.1
Authorization: Bearer <access_token>
X-API-USER-INFO: U1234567890
Accept: application/json

{
  "success": true,
  "data": {
    "wbn": "1234567890123",
    "waybill": "1234567890123",
    "awb_number": "1234567890123",
    "order_id": "DLV-90821",
    "tracking_status": "OUT_FOR_DELIVERY",
    "order_status": "IN_TRANSIT",
    "promised_delivery_date": "2026-10-11",
    "location": "Gurugram DC",
    "origin_city": "Mumbai",
    "destination_city": "Gurugram",
    "o_pincode": "400001",
    "d_pincode": "122001",
    "scans": [{
      "status": "Picked up",
      "location": "Bhiwandi hub",
      "code": "UD"
    }]
  }
}

列出已下单包裹

GET /v1/shipments opendata

分页返回登录客户「我的订单」/首页包裹列表（wbn、order_status、邮编、COD/预付）。

认证方式： Bearer access_token 加对应当前 ucid 的 X-API-USER-INFO。

packages
wbn
order_id
order_status
payment_mode
cod_amount
pickup_pincode
drop_pincode
package_value
package_weight
seller_name
count
page_no

GET /v1/shipments?page_no=1 HTTP/1.1
Authorization: Bearer <access_token>
X-API-USER-INFO: U1234567890
Accept: application/json

{
  "success": true,
  "data": {
    "packages": [{
      "wbn": "1234567890123",
      "order_id": "DLV-90821",
      "order_status": "IN_TRANSIT",
      "payment_mode": "prepaid",
      "cod_amount": 0,
      "pickup_pincode": "400001",
      "drop_pincode": "122001",
      "package_value": 2500,
      "package_weight": 1.2,
      "seller_name": "Home shop"
    }],
    "count": 1,
    "page_no": 1
  }
}

读取 Delhivery Coins 余额

GET /v1/loyalty/balance openfinance

返回金币中心展示的 Delhivery Coins 钱包快照（余额、开通、到期）。

认证方式： Bearer access_token 加 X-API-USER-INFO。

coins
balance
coins_enrolled
coins_redeemed
expiring_coins
expiry_date
coins_unlocked

GET /v1/loyalty/balance HTTP/1.1
Authorization: Bearer <access_token>
X-API-USER-INFO: U1234567890
Accept: application/json

{
  "success": true,
  "data": {
    "coins": 420,
    "balance": 420,
    "coins_enrolled": true,
    "coins_redeemed": 80,
    "expiring_coins": 50,
    "expiry_date": "2026-10-10",
    "coins_unlocked": true
  }
}

分页金币流水

GET /v1/loyalty/ledger openfinance

分页返回交易历史界面背后的金币账本（赚取/核销、milestone、expiry_date）。

认证方式： Bearer access_token 加 X-API-USER-INFO。

transactions
amount
coins
milestone
amount_per_milestone
expiry_date
order_id
count

GET /v1/loyalty/ledger HTTP/1.1
Authorization: Bearer <access_token>
X-API-USER-INFO: U1234567890
Accept: application/json

{
  "success": true,
  "data": {
    "transactions": [{
      "amount": 40,
      "coins": 40,
      "milestone": "first_booking",
      "amount_per_milestone": 40,
      "expiry_date": "2026-12-31",
      "order_id": "DLV-90821"
    }],
    "count": 1
  }
}

创建 Razorpay 支付哈希

POST /v1/checkout/order openfinance

签发支付页使用的 Razorpay 订单哈希；SDK 随后回传 razorpay_payment_id 与 razorpay_signature。

认证方式： Bearer access_token 加 X-API-USER-INFO。结账后再把 razorpay_payment_id 提交到支付确认界面。

order_id
amount
currency
payment_mode
wbn
hash
razorpay_order_id
payment_status

POST /v1/checkout/order HTTP/1.1
Authorization: Bearer <access_token>
X-API-USER-INFO: U1234567890
Content-Type: application/json

{
  "order_id": "DLV-90821",
  "amount": 24900,
  "currency": "INR",
  "payment_mode": "prepaid",
  "wbn": "1234567890123"
}

{
  "success": true,
  "data": {
    "hash": "a1b2c3d4e5",
    "razorpay_order_id": "order_N9abc",
    "amount": 24900,
    "currency": "INR",
    "payment_status": "created"
  }
}

查询邮编可达性

GET /v1/lanes/coverage opendata

告诉下单流程一对取件/派送邮编在 Direct、Local 或 PTL 上是否可达。

认证方式： Bearer access_token 加 X-API-USER-INFO。下单第一步也使用匿名邮编查询。

origin_pincode
drop_pincode
o_pincode
d_pincode
serviceable
is_serviceable
origin_city
destination_city
service_type
order_type

GET /v1/lanes/coverage?origin_pincode=400001&drop_pincode=122001&order_type=direct HTTP/1.1
Authorization: Bearer <access_token>
X-API-USER-INFO: U1234567890
Accept: application/json

{
  "success": true,
  "data": {
    "origin_pincode": "400001",
    "drop_pincode": "122001",
    "o_pincode": "400001",
    "d_pincode": "122001",
    "serviceable": true,
    "is_serviceable": true,
    "origin_city": "Mumbai",
    "destination_city": "Gurugram",
    "service_type": "direct"
  }
}

同城运费估价

GET /v1/local/quote opendata

在取件/派送钉选后报价同城 Local 行程（hl_freight、eta、polyline、vehicle_type）。

认证方式： Bearer access_token 加 X-API-USER-INFO。

estimate
hl_freight
eta
distance
duration
vehicle_type
polyline
currency

GET /v1/local/quote?distance=12.4 HTTP/1.1
Authorization: Bearer <access_token>
X-API-USER-INFO: U1234567890
Accept: application/json

{
  "success": true,
  "data": {
    "estimate": 349,
    "hl_freight": 349,
    "eta": 42,
    "distance": 12.4,
    "duration": 42,
    "vehicle_type": "2w",
    "polyline": "enc:polyline",
    "currency": "INR"
  }
}

零担运费估价

POST /v1/freight/quote opendata

按重量、box_count 与 ewaybill 为零担预订定价，返回 freight、GST 与取件时段。

认证方式： Bearer access_token 加 X-API-USER-INFO。企业下单在 KYC 后还会发送 gstin。

origin_city
destination_city
origin_pincode
drop_pincode
weight
volumetric_weight
box_count
pickup_slot
ewaybill
freight
charged_weight
charged_weight_g
gst
igst
slots
ptl_master_waybill

POST /v1/freight/quote HTTP/1.1
Authorization: Bearer <access_token>
X-API-USER-INFO: U1234567890
Content-Type: application/json

{
  "origin_city": "Mumbai",
  "destination_city": "Pune",
  "origin_pincode": "400001",
  "drop_pincode": "411001",
  "weight": 250,
  "volumetric_weight": 280,
  "box_count": 4,
  "pickup_slot": "2026-10-10T10:00:00+05:30",
  "ewaybill": "341012345678"
}

{
  "success": true,
  "data": {
    "freight": 8420,
    "charged_weight": 280,
    "charged_weight_g": 280000,
    "gst": 1515.6,
    "igst": 1515.6,
    "currency": "INR",
    "slots": ["10:00-13:00", "14:00-18:00"],
    "ptl_master_waybill": null
  }
}

查询计费重量

GET /v1/pricing/billable-weight opendata

把实重与箱规换算成 Direct 报价页使用的 charged_weight_g。

认证方式： Bearer access_token 加 X-API-USER-INFO。

weight_g
charged_weight_g
charged_weight
volumetric_weight
length_cm
width_cm
height_cm
package_value

GET /v1/pricing/billable-weight?weight_g=1200&length_cm=30&width_cm=20&height_cm=15 HTTP/1.1
Authorization: Bearer <access_token>
X-API-USER-INFO: U1234567890
Accept: application/json

{
  "success": true,
  "data": {
    "weight_g": 1200,
    "charged_weight_g": 1800,
    "charged_weight": 1.8,
    "volumetric_weight": 1.8,
    "length_cm": 30,
    "width_cm": 20,
    "height_cm": 15,
    "package_value": 2500
  }
}

发起 Aadhaar DigiLocker KYC

POST /v1/kyc/aadhaar/start osint

启动企业发件人界面使用的 Aadhaar DigiLocker KYC；轮询直到 aadhar_kyc_verified 翻转。

认证方式： Bearer access_token 加 X-API-USER-INFO。GST KYC 是企业发件人界面上的同级流程。

aadhaarNumber
kyc_type
ucid
aadhar_kyc_verified
gst_kyc_verified
gstin
authorization_url

POST /v1/kyc/aadhaar/start HTTP/1.1
Authorization: Bearer <access_token>
X-API-USER-INFO: U1234567890
Content-Type: application/json

{
  "aadhaarNumber": "XXXX-XXXX-1234",
  "kyc_type": "aadhaar",
  "ucid": "U1234567890"
}

{
  "success": true,
  "data": {
    "kyc_type": "aadhaar",
    "aadhar_kyc_verified": false,
    "gst_kyc_verified": false,
    "gstin": "",
    "authorization_url": "https://kyc.example/aadhaar/callback"
  }
}

更新派送指示

POST /v1/shipments/{wbn}/instructions opendata

写入挂在运单上的收件人派送指示卡片（邻里代收、地标）。

认证方式： Bearer access_token 加 X-API-USER-INFO。收件人必须拥有该 wbn。

wbn
instructions
neighbor
landmark
address_id

POST /v1/shipments/{wbn}/instructions HTTP/1.1
Authorization: Bearer <access_token>
X-API-USER-INFO: U1234567890
Content-Type: application/json

{
  "wbn": "1234567890123",
  "instructions": "Leave with neighbour in 12-B",
  "neighbor": "Ravi",
  "landmark": "Blue gate",
  "address_id": "addr_88"
}

{
  "success": true,
  "data": {
    "wbn": "1234567890123",
    "instructions": "Leave with neighbour in 12-B",
    "neighbor": "Ravi",
    "landmark": "Blue gate",
    "address_id": "addr_88"
  }
}

列出支持工单

GET /v1/help/tickets opendata

列出帮助收件箱中的客户支持工单（ticket_id、wbn、status）。

认证方式： Bearer access_token 加 X-API-USER-INFO。

tickets
ticket_id
public_ticket_id
wbn
status
comment
attachment
count

GET /v1/help/tickets HTTP/1.1
Authorization: Bearer <access_token>
X-API-USER-INFO: U1234567890
Accept: application/json

{
  "success": true,
  "data": {
    "tickets": [{
      "ticket_id": "TCK-4412",
      "public_ticket_id": "DLV-TCK-4412",
      "wbn": "1234567890123",
      "status": "open",
      "comment": "Package delayed past promised_delivery_date",
      "attachment": null
    }],
    "count": 1
  }
}

数据类别

跟踪
运单
支付
忠诚度
KYC
可达性
客服

数据使用场景与案例

OMS 运单对账
卖家 OMS 按 wbn 轮询统一跟踪，把 tracking_status、scans 与 promised_delivery_date 合并进订单行，客服不必再刮公开跟踪页。
结账线路预检
店面前端在承诺 Direct 或 Local 派送前，用 origin_pincode 与 drop_pincode 查可达性，并用 charged_weight_g 与 hl_freight 展示落地价。
货到付款与金币账本
财务把 payment_mode / cod_amount / razorpay_order_id 与金币账本（balance、coins_redeemed、expiry_date）拼接，对预付结账与忠诚度核销。
发件人 KYC 门槛
B2B 开通流程在 DigiLocker / GST OTP 之后读取 aadhar_kyc_verified 与 gstin，只有核验过的 ucid 才能创建需要 ewaybill 的零担订单。

常见问题

Delhivery 快递应用暴露哪些跟踪字段？

统一跟踪返回 wbn / waybill / awb_number、tracking_status、order_status、promised_delivery_date、取件与派送邮编，以及 scans 时间线。首页包裹列表用同样的标识分页，并带 payment_mode 与 cod_amount。

这套 API 如何登录？

先请求手机 OTP，再在客户访问接口换成 access_token、refresh_token、session_token 与 ucid。后续调用携带 Authorization: Bearer 与 X-API-USER-INFO；专用刷新路径轮换访问令牌。

有没有钱包或忠诚度余额？

有。Delhivery Coins 暴露 coins / balance、开通状态、coins_redeemed、expiring_coins 与 expiry_date，另有按 milestone 与 order_id 排列的流水。预付结账走 Razorpay 哈希，不是储值钱包。

下单前能查邮编是否可达吗？

可达性调用接受 origin_pincode 与 drop_pincode（以及 o_pincode / d_pincode），返回 serviceable / is_serviceable 以及 origin_city、destination_city，覆盖 Direct、Local 与 PTL 线路。

与 Delhivery: Courier App 相似的应用

Blue Dart — Blue Dart Express 是印度快递物流公司（DHL 控股），提供特快包裹、货代与货到付款，常被当作 Delhivery 在全国消费件与电商件上的替代。
DTDC — DTDC Express 是班加罗尔的快递公司，可通过 MyDTDC 应用预订上门特快包裹并实时跟踪，也提供货运和 2–4 小时的 Raftaar 配送。
Porter - Logistics Service App — Porter 是班加罗尔的按需物流应用，可预订小货车、三轮和两轮车做同城搬运，也提供城际快递；Delhivery Direct 正是为这一线路推出的竞品。
Shadowfax Courier — Shadowfax 的快递应用面向个人和小商家提供同城按需取送，并覆盖印度各地邮编的特快包裹网络。
India Post Speed Post — 印度邮政 Speed Post 是国家邮政的限时信函与包裹业务，同时也承接预付和货到付款的电商件。
Xpressbees — Xpressbees 是浦那的物流公司，2015 年从 FirstCry 分拆，提供包裹派送、退货物流、仓储和跨境运输。
Borzo: Courier Delivery App — Borzo 是同城按需快递，报道将它列为 Delhivery Direct 在两轮包裹取送上要竞争的对手之一。

需要集成这个 App 的数据 API？

我们可为任意指定 App 交付定制集成——源码交付 USD 500 起，或托管 API 按调用计费。告诉我们您需要的数据即可。

每个项目均签 NDA 与 SOW
3–7 天交付
验收通过后才付款
仅在授权范围内作业

获取报价

Delhivery 快递应用数据 API：运单、金币、KYC

应用截图

API 端点一览

请求登录 OTP

用 OTP 换取客户访问令牌

刷新会话令牌

统一运单跟踪

列出已下单包裹

读取 Delhivery Coins 余额

分页金币流水

创建 Razorpay 支付哈希

查询邮编可达性

同城运费估价

零担运费估价

查询计费重量

发起 Aadhaar DigiLocker KYC

更新派送指示

列出支持工单

数据类别

数据使用场景与案例

OMS 运单对账

结账线路预检

货到付款与金币账本

发件人 KYC 门槛

常见问题

与 Delhivery: Courier App 相似的应用

更多出行类应用

99 Motorista e Entregador

Amazon Flex

Australia Post

Borzo: Courier Delivery App

相关主题

需要集成这个 App 的数据 API？

Delhivery 快递应用数据 API：运单、金币、KYC

应用截图

API 端点一览

请求登录 OTP

用 OTP 换取客户访问令牌

刷新会话令牌

统一运单跟踪

列出已下单包裹

读取 Delhivery Coins 余额

分页金币流水

创建 Razorpay 支付哈希

查询邮编可达性

同城运费估价

零担运费估价

查询计费重量

发起 Aadhaar DigiLocker KYC

更新派送指示

列出支持工单

数据类别

数据使用场景与案例

OMS 运单对账

结账线路预检

货到付款与金币账本

发件人 KYC 门槛

常见问题

相关应用

与 Delhivery: Courier App 相似的应用

更多出行类应用

99 Motorista e Entregador

Amazon Flex

Australia Post

Borzo: Courier Delivery App

相关主题

需要集成这个 App 的数据 API？