Amazon Flex 班次、收入与行程数据 API

Amazon Mobile LLC · 出行

Amazon Flex 是 Amazon Mobile LLC 推出的末端配送应用，独立配送员用它预约亚马逊包裹班次、到站取件、按停靠点送货并领取报酬。配送员使用 Amazon 账号登录，选择可服务区域，在 Reserve Now 或排班报价里查看时间窗、站点和报酬后再接单；班次开始后到站签到、扫描包裹、按行程配送住宅、储物柜和商家，结束后关闭工作会话。收入与付款页列出已结算班次并支持提现到银行账户，即时报价可在班次中追加停靠，入职流程覆盖证件、车辆、保险与背景调查。Flex 是亚马逊在美国、墨西哥、巴西、德国和印度等地的零工末端运力，与 DSP 员工流程共用同一套配送工具，并与 Walmart Spark Driver、Uber Driver、DoorDash Dasher 争夺同一批独立快递员。

班次卡上的 projectedEarnings 与 surgeMultiplier 标出接单前收入，结算后进入 currentBalance，行程则落到 stops 与 packages。

薪酬与风控用 providerEarnings、cashoutEligibilityStatus 和 accountNumberTail 对账后再发起提现；运力工具读取履约行程与当前 sessionId。openData Studio 把这些对象做成可调用的开放数据。

应用截图

API 端点一览

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

配送员可接报价

POST /v1/flex/offers opendata

列出已登录配送员的 Reserve Now 与排班班次报价：offerList 含时间窗、serviceAreaId、deliveryAreaDisplayName 与 rateInfo（projectedEarnings、surgeMultiplier）。

认证方式： Flex 登录后 Amazon 账号访问令牌，放在请求头 x-amz-access-token

apiVersion
providerId
serviceAreaIds
statusFilter
filters
offerExperienceVersion
refreshInterval
refreshTimeout
offerList
offerId
offerType
status
startTime
endTime
expirationDate
serviceAreaId
deliveryAreaDisplayName
rateInfo
currency
isSurge
priceAmount
projectedEarnings
projectedTips
surgeMultiplier
upfrontTips

POST /v1/flex/offers HTTP/1.1
x-amz-access-token: Atza|IwE...
Content-Type: application/json

{
  "apiVersion": "V2",
  "providerId": "amzn1.flex.provider.7f21c0a4",
  "serviceAreaIds": ["seattlesouth"],
  "statusFilter": "AVAILABLE",
  "filters": {}
}

{
  "offerExperienceVersion": "V3",
  "refreshInterval": 30,
  "refreshTimeout": 120,
  "offerList": [
    {
      "offerId": "off_7f21c0a4",
      "offerType": "BLOCK",
      "status": "AVAILABLE",
      "startTime": "2026-10-02T15:00:00.000Z",
      "endTime": "2026-10-02T19:00:00.000Z",
      "expirationDate": "2026-10-02T14:55:00.000Z",
      "creationDate": "2026-10-02T13:10:00.000Z",
      "serviceAreaId": "seattlesouth",
      "serviceTypeId": "AMZL",
      "deliveryAreaDisplayName": "Seattle South",
      "deliveryAreaRegionId": "SEA",
      "isPriorityOffer": false,
      "hidden": false,
      "locationTrackingRequired": true,
      "maxWorkload": 40,
      "schedulingType": "BLOCK",
      "legalEntity": "Amazon.com Services LLC",
      "rateInfo": {
        "currency": "USD",
        "isSurge": true,
        "priceAmount": 72.5,
        "projectedEarnings": 72.5,
        "projectedTips": 0,
        "surgeMultiplier": "1.2",
        "upfrontTips": 0
      }
    }
  ]
}

报价详情

GET /v1/flex/offers/{offerId} opendata

按 offerId 加载 SchedulingOffer，支撑报价详情页：时间窗、站点 startingLocation、工作量与 rateInfo。

认证方式： Flex 登录后 Amazon 账号访问令牌，放在请求头 x-amz-access-token

offerId
providerId
datasetList
offer
offerType
status
startTime
endTime
serviceAreaId
deliveryAreaDisplayName
startingLocation
locationTrackingRequired
maxWorkload
rateInfo
projectedEarnings
surgeMultiplier

GET /v1/flex/offers/off_7f21c0a4 HTTP/1.1
x-amz-access-token: Atza|IwE...

{
  "offer": {
    "offerId": "off_7f21c0a4",
    "offerType": "BLOCK",
    "status": "AVAILABLE",
    "startTime": "2026-10-02T15:00:00.000Z",
    "endTime": "2026-10-02T19:00:00.000Z",
    "serviceAreaId": "seattlesouth",
    "deliveryAreaDisplayName": "Seattle South",
    "locationTrackingRequired": true,
    "maxWorkload": 40,
    "startingLocation": {
      "address": "440 Terry Ave N, Seattle, WA"
    },
    "rateInfo": {
      "currency": "USD",
      "isSurge": true,
      "priceAmount": 72.5,
      "projectedEarnings": 72.5,
      "surgeMultiplier": "1.2"
    }
  }
}

接受班次报价
POST /v1/flex/offers/{offerId}/accept opendata
接受班次报价，返回排班与会话所依赖的 providerReservationId、workSegmentId。
认证方式： Flex 登录后 Amazon 账号访问令牌，放在请求头 x-amz-access-token
- offerId
- providerId
- providerReservationId
- workSegmentId
```
POST /v1/flex/offers/off_7f21c0a4/accept HTTP/1.1
x-amz-access-token: Atza|IwE...
Content-Type: application/json

{
  "offerId": "off_7f21c0a4",
  "providerId": "amzn1.flex.provider.7f21c0a4"
}
```
```
{
  "providerReservationId": "res_9c81e2b0",
  "workSegmentId": "ws_44102"
}
```

已预约班次

GET /v1/flex/assignments opendata

返回配送员已预约日历：scheduledAssignments 含 startTime、durationInMinutes、serviceAreaId、status 与 bookedPrice。

认证方式： Flex 登录后 Amazon 账号访问令牌，放在请求头 x-amz-access-token

startDate
endDate
scheduledAssignments
scheduledAssignmentId
providerId
startTime
durationInMinutes
serviceAreaId
status
schedulingType
maxWorkload
locationTrackingRequired
bookedPrice
amount
currency
projectedEarnings

GET /v1/flex/assignments?startDate=2026-10-01T00:00:00.000Z&endDate=2026-10-08T00:00:00.000Z HTTP/1.1
x-amz-access-token: Atza|IwE...

{
  "scheduledAssignments": [
    {
      "scheduledAssignmentId": "sa_12ab",
      "providerId": "amzn1.flex.provider.7f21c0a4",
      "startTime": "2026-10-02T15:00:00.000Z",
      "durationInMinutes": 240,
      "serviceAreaId": "seattlesouth",
      "serviceTypeId": "AMZL",
      "status": "RESERVED",
      "schedulingType": "BLOCK",
      "maxWorkload": 40,
      "locationTrackingRequired": true,
      "legalEntity": "Amazon.com Services LLC",
      "deliveryAreaRegionId": "SEA",
      "bookedPrice": {
        "amount": 72.5,
        "currency": "USD",
        "projectedEarnings": 72.5,
        "projectedTips": 0
      }
    }
  ]
}

可服务区域
GET /v1/flex/service-areas opendata
返回已登录配送员可接单的 serviceAreaIds，供报价与排班的区域筛选使用。
认证方式： Flex 登录后 Amazon 账号访问令牌，放在请求头 x-amz-access-token
- serviceAreaIds
```
GET /v1/flex/service-areas HTTP/1.1
x-amz-access-token: Atza|IwE...
```
```
{
  "serviceAreaIds": ["seattlesouth", "bellevue", "tukwila"]
}
```

配送员收入汇总

GET /v1/flex/earnings openfinance

支撑收入首页：currentBalance 与按日期窗口分页的 providerEarnings（identifier、type、status、settlementTime）。

认证方式： Flex 登录后 Amazon 账号访问令牌，放在请求头 x-amz-access-token

startDate
endDate
providerId
providerType
includeCurrentBalance
locale
pageSize
pageToken
currentBalance
amount
currency
providerEarnings
identifier
type
subType
status
earningsDate
settlementTime
actualSettlementTime
paymentPreference
biller

GET /v1/flex/earnings?startDate=2026-09-01T00:00:00.000Z&endDate=2026-10-01T00:00:00.000Z&providerId=amzn1.flex.provider.7f21c0a4&providerType=FLEX&includeCurrentBalance=true&locale=en_US&pageSize=20 HTTP/1.1
x-amz-access-token: Atza|IwE...

{
  "currentBalance": {"amount": 214.75, "currency": "USD"},
  "providerEarnings": [
    {
      "identifier": "pe_884211",
      "type": "BLOCK",
      "subType": "STANDARD",
      "status": "SETTLED",
      "earningsDate": "2026-09-24T19:10:00.000Z",
      "settlementTime": "2026-09-25T08:00:00.000Z",
      "actualSettlementTime": "2026-09-25T08:04:00.000Z",
      "paymentPreference": "BANK_ACCOUNT"
    }
  ],
  "biller": {"billerId": "bl_sea_01"},
  "pageToken": null
}

明细收入

GET /v1/flex/earnings/{identifier} openfinance

把一条收入拆成 ProviderEarningsItem 行（amount、description、type）及 blocksInDeposit 分组，支撑明细收入页。

认证方式： Flex 登录后 Amazon 账号访问令牌，放在请求头 x-amz-access-token

identifier
locale
items
amount
description
type
blocksInDeposit
workEarningTransactionDetails

GET /v1/flex/earnings/pe_884211?locale=en_US HTTP/1.1
x-amz-access-token: Atza|IwE...

{
  "items": [
    {"amount": {"amount": 72.5, "currency": "USD"}, "description": "Block pay", "type": "BASE"},
    {"amount": {"amount": 8.0, "currency": "USD"}, "description": "Surge", "type": "SURGE"}
  ],
  "blocksInDeposit": [
    {
      "identifier": "pe_884211",
      "type": "BLOCK",
      "status": "SETTLED",
      "earningsDate": "2026-09-24T19:10:00.000Z"
    }
  ],
  "workEarningTransactionDetails": []
}

提现资格
GET /v1/flex/payouts/eligibility openfinance
判断能否提现：isEligible、cashoutEligibilityStatus、可用余额、accountNumberTail，以及随后发起提现用的 batchId。
认证方式： Flex 登录后 Amazon 账号访问令牌，放在请求头 x-amz-access-token
- entityType
- entityId
- locale
- isEligible
- cashoutEligibilityStatus
- balance
- accountNumberTail
- accountType
- batchId
- ineligibilityReasonTitle
- ineligibilityReasonMessage
```
GET /v1/flex/payouts/eligibility?entityType=PROVIDER&entityId=amzn1.flex.provider.7f21c0a4&locale=en_US HTTP/1.1
x-amz-access-token: Atza|IwE...
```
```
{
  "isEligible": true,
  "cashoutEligibilityStatus": "ELIGIBLE",
  "balance": {"amount": 214.75, "currency": "USD"},
  "accountNumberTail": "1192",
  "accountType": "CHECKING",
  "batchId": "bat_20261002",
  "ineligibilityReasonTitle": null,
  "ineligibilityReasonMessage": null
}
```

发起配送员提现

POST /v1/flex/payouts openfinance

把合格批次提现到已绑定银行尾号；返回 cashoutAmount 及付款页成功/错误文案。

认证方式： Flex 登录后 Amazon 账号访问令牌，放在请求头 x-amz-access-token

accountTail
batchId
documentPriority
entityId
entityType
locale
paymentSpeed
transactionFee
cashoutAmount
cashoutSuccessMessage
disclaimerMessage
errorMessageTitle
errorMessageBody

POST /v1/flex/payouts HTTP/1.1
x-amz-access-token: Atza|IwE...
Content-Type: application/json

{
  "accountTail": "1192",
  "batchId": "bat_20261002",
  "documentPriority": "STANDARD",
  "entityId": "amzn1.flex.provider.7f21c0a4",
  "entityType": "PROVIDER",
  "locale": "en_US",
  "paymentSpeed": "STANDARD",
  "transactionFee": "0"
}

{
  "cashoutAmount": {"amount": 214.75, "currency": "USD"},
  "cashoutSuccessMessage": "Your cash out is on the way.",
  "disclaimerMessage": "Bank transfers may take 1-3 business days.",
  "errorMessageTitle": null,
  "errorMessageBody": null
}

刷新履约行程

POST /v1/flex/itinerary opendata

拉取取件、扫描与配送使用的履约行程：stops、substops、packages、addresses 与 trIdToFulfillmentIdsMap。

认证方式： Flex 登录后 Amazon 账号访问令牌，放在请求头 x-amz-access-token

transporterContext
startDateOfSchedule
endDateOfSchedule
itineraryType
itineraryReceived
startTransporterSession
refreshToken
deviceMetadata
correlationIds
fulfillmentBasedItinerary
addresses
packages
stops
substops
fulfillments
places
itemList
containers
trIdToFulfillmentIdsMap
workflowConstructs

POST /v1/flex/itinerary HTTP/1.1
x-amz-access-token: Atza|IwE...
Content-Type: application/json

{
  "transporterContext": {"providerId": "amzn1.flex.provider.7f21c0a4"},
  "startDateOfSchedule": "2026-10-02T15:00:00.000Z",
  "endDateOfSchedule": "2026-10-02T19:00:00.000Z",
  "itineraryType": "DELIVERY",
  "itineraryReceived": true,
  "startTransporterSession": false,
  "refreshToken": "rt_1a2b",
  "deviceMetadata": {}
}

{
  "correlationIds": ["cid_9f3"],
  "fulfillmentBasedItinerary": {
    "addresses": [{"addressId": "addr_1", "line1": "440 Terry Ave N"}],
    "packages": [{"scannableId": "TBA123456789000"}],
    "stops": [{"stopId": "st_01", "sequence": 1}],
    "substops": [{"substopId": "ss_01"}],
    "fulfillments": [{"fulfillmentId": "ff_01"}],
    "places": [{"placeId": "pl_station"}],
    "itemList": [],
    "containers": [],
    "trIdToFulfillmentIdsMap": {"tr_44102": ["ff_01"]},
    "workflowConstructs": []
  }
}

配送员资料
GET /v1/flex/person osint
加载已登录配送员 Person 卡：姓名、邮箱、电话、countryCode、availabilityStatus、operationalStatus、personCompanyType 与 transportationMode。
认证方式： Flex 登录后 Amazon 账号访问令牌，放在请求头 x-amz-access-token
- person
- firstName
- lastName
- fullName
- email
- phoneNumber
- workPhoneNumber
- countryCode
- title
- address
- availabilityStatus
- operationalStatus
- personCompanyType
- personTypes
- transportationMode
- presignedPhotoFileUrl
- federatedIdentities
- behaviors
```
GET /v1/flex/person HTTP/1.1
x-amz-access-token: Atza|IwE...
```
```
{
  "person": {
    "firstName": "Alex",
    "lastName": "Rivera",
    "fullName": "Alex Rivera",
    "email": "[email protected]",
    "phoneNumber": "+14155550199",
    "workPhoneNumber": "+14155550199",
    "countryCode": "US",
    "title": "Delivery Partner",
    "availabilityStatus": "AVAILABLE",
    "operationalStatus": "ACTIVE",
    "personCompanyType": "CSP",
    "transportationMode": "CAR"
  }
}
```

当前工作会话

GET /v1/flex/session opendata

读取签到后的工作会话：sessionId、status、serviceAreaId、providerReservationId、workEligibility 与 expectedSessionEndTime。

认证方式： Flex 登录后 Amazon 账号访问令牌，放在请求头 x-amz-access-token

session
sessionId
status
sessionStartTime
expectedSessionEndTime
scheduledStartTime
serviceAreaId
providerReservationId
companyId
transportationMode
schedulingType
locked
workEligibility
arrivalRequirements
workHourContext
routeAssignmentTask
sessionConfigurationMap

GET /v1/flex/session HTTP/1.1
x-amz-access-token: Atza|IwE...

{
  "session": {
    "sessionId": "sess_44a1",
    "status": "ACTIVE",
    "sessionStartTime": "2026-10-02T14:52:00.000Z",
    "expectedSessionEndTime": "2026-10-02T19:00:00.000Z",
    "scheduledStartTime": "2026-10-02T15:00:00.000Z",
    "serviceAreaId": "seattlesouth",
    "providerReservationId": "res_9c81e2b0",
    "companyId": "amzn1.flex.company.csp",
    "transportationMode": "CAR",
    "schedulingType": "BLOCK",
    "locked": false,
    "workEligibility": "ELIGIBLE"
  },
  "routeAssignmentTask": null,
  "sessionConfigurationMap": {}
}

数据类别

班次报价
收入
提现
行程
身份
会话

数据使用场景与案例

零工薪酬对账
薪酬或放贷系统夜间拉取 providerEarnings、currentBalance 与明细 amount/description/type，对照 bookedPrice 后再出税表或垫款。
末端行程叠加
路径工具读取 fulfillmentBasedItinerary 的 stops、packages、trIdToFulfillmentIdsMap 以及当前 sessionId，调度无需打开配送员端即可看到剩余 substops。
班次供给监控
运营看板对照 offerList 的 projectedEarnings、surgeMultiplier、可服务 serviceAreaIds 与 scheduledAssignments，判断哪些站点仍有空班。
即时提现资格
钱包集成读取 cashoutEligibilityStatus、accountNumberTail 与 batchId，仅在 isEligible 为真时发起 InitiateProviderCashout。

常见问题

Amazon Flex 会暴露配送员哪些数据？

班次报价（offerId、startTime、endTime、projectedEarnings、surgeMultiplier）、已预约 scheduledAssignments、带 currentBalance 的明细 providerEarnings、提现资格、含 stops 与 packages 的履约行程、配送员 Person 卡，以及当前工作会话。

Amazon Flex 如何鉴权？

Amazon 账号登录后，客户端在报价、收入、行程、资料与会话请求上携带 x-amz-access-token。

能否程序化提取 Flex 收入？

可以。GetCashoutEligibility 返回 isEligible、cashoutEligibilityStatus、balance、accountNumberTail 与 batchId；InitiateProviderCashout 再提交该批次并返回 cashoutAmount。

Flex 班次和网约车行程报价有何不同？

Flex 是带站点 startingLocation 与 maxWorkload 的预约时间块，不是单次载客。报酬在报价上以 projectedEarnings 预先展示，之后作为 providerEarnings 结算。

与 Amazon Flex 相似的应用

Spark Driver — Spark Driver 是沃尔玛面向独立承包司机的应用，用私家车为 Walmart 及其他商家送货，也可到店代购后再配送。
DoorDash - Dasher — DoorDash 的 Dasher 应用让独立配送员按自己的时间接餐厅、杂货和零售配送单，主要覆盖美国。
Uber - Driver: Drive & Deliver — Uber 司机端让合作伙伴接载客行程，也可开车、骑车、滑板车或步行配送餐饮、杂货和包裹。
Instacart — Instacart 是面向美国和加拿大的杂货配送与到店自取服务，由个人购物员到合作零售店拣货、打包并送货。
iFood para Entregadores — iFood 配送员应用是巴西 iFood 点餐平台的运力端，合作配送员登记后可用自行车、滑板车、摩托车、汽车或步行送餐。
Soy Rappi - Sé un repartidor — Soy Rappi 是哥伦比亚波哥大超级应用 Rappi 的配送端，合作骑手在墨西哥、巴西等拉美市场配送餐饮、杂货及其他即时订单。
Porter Driver Partner App — Porter 司机端是印度同城即时物流应用，司机可用两轮、三轮、tempo 或小货车承接货运单并按日结算。

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

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

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

获取报价

Amazon Flex 班次、收入与行程数据 API

应用截图

API 端点一览

配送员可接报价

报价详情

接受班次报价

已预约班次

可服务区域

配送员收入汇总

明细收入

提现资格

发起配送员提现

刷新履约行程

配送员资料

当前工作会话

数据类别

数据使用场景与案例

零工薪酬对账

末端行程叠加

班次供给监控

即时提现资格

常见问题

与 Amazon Flex 相似的应用

更多出行类应用

Careem Captain

Dostavista — работа курьером

Lyft Driver

Ola Driver App

相关主题

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

Amazon Flex 班次、收入与行程数据 API

应用截图

API 端点一览

配送员可接报价

报价详情

接受班次报价

已预约班次

可服务区域

配送员收入汇总

明细收入

提现资格

发起配送员提现

刷新履约行程

配送员资料

当前工作会话

数据类别

数据使用场景与案例

零工薪酬对账

末端行程叠加

班次供给监控

即时提现资格

常见问题

相关应用

与 Amazon Flex 相似的应用

更多出行类应用

Careem Captain

Dostavista — работа курьером

Lyft Driver

Ola Driver App

相关主题

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