Order status
Read a placed order’s delivery stage and arrival estimate.
Merchants that report a delivery stage
- DoorDash
picked_up or arriving, while tracking is live. An order at any other merchant answers placed, confirmed or canceled from what the merchant told checkout, with tracking: not_available.Authorizations
The user's connection access_token (user authentication), or an org-minted buy_token for org-owned accounts.
Path Parameters
The order_id from order.placed, or from an order in GET /buy/conversations/{id}.
Query Parameters
The connected person whose order this is. Required with a platform access token: a read that leaves it out is refused with 400 user_id_required. Leave it out with a user token, which names the person itself.
Response
The order.
The delivery stage, in Agentcard's words for every merchant.
placed, confirmed, courier_assigned, courier_at_store, ready_for_pickup, picked_up, arriving, delivered, canceled When the order reached this stage.
The arrival window the merchant quotes, or null when it quotes none.
live while Agentcard follows the order, ended once it stopped (delivered, canceled, past six hours, or gone from the merchant more than two hours after it was placed), not_available for a merchant it cannot follow.
live, ended, not_available When Agentcard last tried to read the order from the merchant. A try that read nothing moves this time too, so read status_updated_at for how old the stage itself is.