Skip to content

JSON structure

Field Type Description
order_id String The order’s internal identifier.
order_code String The order’s alphanumeric code, printed on the receipt. The lookup and deduplication key.
store_id String The store identifier, formatted partner_name__store_id.
order_time String When the order was accepted, yyyy-MM-dd HH:mm:ss, store local time.
estimated_pickup_time String Estimated pick-up time, same format.
order_type String pickup (a courier collects it) or delivery (you deliver). See the note below.
is_picked_up_by_customer Boolean The customer collects the order in person.
payment_method String DELAYED (paid online by card) or CASH (cash on delivery).
payment_total Integer The amount to collect, in subunits.
currency String The currency, for example RON.
pick_up_code String A 3-digit code identifying the order at hand-over.
cutlery_requested Boolean The customer asked for cutlery.
allergy_info String Free text written by the customer about allergies or preferences.
special_requirements String Special requirements, if any.
customer_cash_payment_amount Integer The amount the customer pays with, so you can prepare change. Marketplace, cash only.
minimum_basket_surcharge Integer Minimum-basket surcharge. Marketplace only.
loyalty_card String Loyalty card, when transmitted.
traceCode, traceId String Internal request identifiers. You do not need them.
Field Type Description
products Array The ordered products.
courier Object Courier details. null for marketplace.
customer Object Customer details. Complete only for marketplace.
delivery_address Object Delivery address. Marketplace only.
fees Array Fees paid by the customer.
discounts Array Discounts applied.
detailed_fees Array Itemised fees, by code.
glovo_discounts Array Discounts borne by the platform.
restaurant_discounts Array Discounts borne by the restaurant.
products_total Integer Product total, before fees and discounts.
bundled_orders Array Orders delivered together with this one.
Field Type Description
id String The product identifier, exactly as you sent it in the menu.
purchased_product_id String Unique identifier of the line within the order.
name String Product name.
quantity Integer Quantity.
price Integer Unit price, in subunits.
discount Integer Discount applied at product level.
attributes Array Options chosen for this product.
Field Type Description
id String The attribute identifier, from the menu you sent.
name String Name.
quantity Integer Quantity chosen.
price Integer Price. 0 means a free option; above 0, a paid extra.

Attribute prices are separate from the product’s price. The line total is price × quantity plus the sum of the attributes.

Field Type Description
name String For courier delivery, only the first name and an initial.
phone_number String N/A for courier delivery.
hash String An anonymous identifier, stable for the same customer.
invoicing_details Object Invoicing details. null when no invoice was requested.
Field Type Description
name String Courier name. null for marketplace.
phone_number String Courier phone. null for marketplace.
Field Type Description
label String The full address, as unstructured text.
latitude Double Latitude.
longitude Double Longitude.

The address is not broken down into street, number and city. If you need components, use the coordinates.

fees, discounts, detailed_fees, glovo_discounts and restaurant_discounts all share the same shape:

Field Type Description
code String The fee or discount code.
description String Text description. May be null.
value Integer The value, in subunits.

Codes you will see:

List Codes
detailed_fees DeliveryFee, MinimumBasketSurcharge, ServiceFee
glovo_discounts GlovoDiscount, GlovoSupportedDeliveryFee, Other
restaurant_discounts RestaurantDiscount