Order API

Order API allows integrated partners to retrieve order details from Wolt and send them to their POS, KDS or other systems.

The API is designed to help our partners reduce the time they spend managing orders they receive through Wolt. By using all endpoints you can develop an experience that helps manage Wolt orders without the Wolt Merchant app.

Environments

Production

Test

https://pos-integration-service.wolt.com

On this page

Summary Authentication OrderV2 OrderV2 object Order Order object

Authentication

Bearer authentication

The JWT token is used for authentication and is obtained as part of the OAuth 2.0 flow. For detailed implementation guidance, refer to the documentation.

You can get credentials by contacting your Wolt account manager or technical account manager.

OrderV2

With Order V2, a more detailed breakdown of pricing of the order is provided. The pricing structure (all of it, or some of it) may be required for order creation in the POS system, taking into account the proper mapping of discounts.

Please note that any enum defined may get additional values at any point in time. Moreover, additional JSON properties may be added.

Endpoints

get/v2/orders/{orderId}

The OrderV2 object

Properties

idstring

Unique identifier for the order.

venueobject

Details of the venue where the order was placed.

basket_priceobject

Details of the basket price (ordered items and mofidiers only, excluding fees).

deliveryobject

Details about the delivery.

feesobject

Detailed fee breakdown for the order.

items[object]

Items included in the order.

created_atstringnullable

Required. The date and time (ISO 8601 format) when the order was received by Wolt's system.

consumer_commentstringnullable

Required. Comment added to the order by consumer.

When making an order using Wolt app, a consumer can leave a message to the restaurant. For example to inform the kitchen about dietary restrictions.

consumer_namestringnullable

Required. Name of the consumer who made the order.

If a self-delivery venue has full name setting enabled they will receive the full name of the consumer, otherwise the name will include only first name and first letter of last name.

consumer_phone_numberstringnullable

Required. Phone number of the consumer who made the order.

Consumer phone number is not shared unless absolutely necessary. This is toggled on only for select markets where the phone number is available on the Wolt Merchant app or for self-delivery venues. The field is null in all other cases.

pickup_etastringnullable

Required. The date and time (ISO 8601 format) when the courier is expected to pick up the order.

attribution_idstringnullable

Required. Unique identifier for the attribution.

This is used to track consumer "source" if the consumer is coming to Wolt from a merchant's website or app. Merchants can create a unique attribution IDs for a campaign or source and pass it to Wolt. This ID is carried through the order flow and reflected in the order.

typestringenum: preorder, instant

An order can be of two different types.

instant: When an order is to be fulfilled instantly.
preorder: When a consumer schedules an order.

pre_orderobjectnullable

Required. Pre-order details for the order.

order_numberstring

A human readable order number that is unique only for open orders. Order numbers can repeat and are not unique for a venue.

order_statusstringenum: received, fetched, acknowledged, production, ready, delivered, rejected, other

Status of the order. An order progresses through a life cycle that consists of different states:

received: The order was fetched by the Wolt Merchant app and/or acknowledged by venue staff on the app.
fetched: The order was fetched in the Wolt Merchant app.
acknowledged: The order was interacted by venue staff on the Wolt Merchant app.
production: Preparation of the order has started.
ready: The order has been prepared and is awaiting delivery.
delivered: The order has been delivered to the consumer.
rejected: The venue or Wolt's system rejected the order.
other: Other unknown status.

modified_atstringnullable

Required. Order modification time (UTC - ISO-8601 format)

company_tax_idstringnullable

Required. Unique identifier for company tax.

In some markets, consumers are allowed to bill their company for the purchase. In these situations they input the company's tax ID and this information is passed on for accounting purposes.

loyalty_card_numberstringnullable

Required. Loyalty card number given by consumer during checkout from a retail venue.

This can be only used to add points for the consumer based on the purchase. No validation of this number takes place in Wolt's system.

cash_paymentobjectnullable

Required. Contains information about cash payment of the order.

With this information the courier will be able to request correct amount of cash from the customer and also reserve enough change in case customer does not have even amount in cash.

merchantobjectnullable

Required. Contains information about the merchant who is responsible for the order.

This is relevant only for self-delivery venues.

OrderV2 object example

{
  "id": "68656c6c6f6f726465727632",
  "venue": {
    "id": "68656c6c6f76326f72646572",
    "name": "Wolt's Cafe",
    "external_venue_id": "wolt_external_store"
  },
  "basket_price": {
    "total": {
      "amount": 4927,
      "currency": "EUR"
    },
    "price_breakdown": {
      "total_before_discounts": {
        "amount": 5925,
        "currency": "EUR"
      },
      "total_discounts": {
        "amount": 998,
        "currency": "EUR"
      },
      "subtotal_basket_discounts": {
        "amount": 548,
        "currency": "EUR"
      },
      "subtotal_item_discounts": {
        "amount": 450,
        "currency": "EUR"
      }
    }
  },
  "delivery": {
    "status": "none",
    "type": "homedelivery",
    "time": "2024-01-01T12:00:00.000Z",
    "location": {
      "street_address": "Pohjoinen Rautatiekatu 21",
      "apartment": "",
      "city": "Helsinki",
      "country": "FIN",
      "coordinates": {
        "lon": 60.1700444,
        "lat": 24.9254858
      },
      "formatted_address": "Pohjoinen Rautatiekatu 21\n00100 Helsinki\nFIN\n\nEntrance / Staircase: 1\nName / Number on the door: 1"
    },
    "self_delivery": false
  },
  "fees": {
    "total": {
      "amount": 145,
      "currency": "EUR"
    },
    "price_breakdown": {
      "total_before_discounts": {
        "amount": 295,
        "currency": "EUR"
      },
      "total_discounts": {
        "amount": 150,
        "currency": "EUR"
      },
      "liability": {
        "amount": 0,
        "currency": "EUR"
      }
    },
    "parts": [
      {
        "type": "type_base_delivery",
        "total": {
          "amount": 60,
          "currency": "EUR"
        },
        "vat_percentage": 12
      },
      {
        "type": "type_base_delivery",
        "total": {
          "amount": 40,
          "currency": "EUR"
        },
        "vat_percentage": 19
      },
      {
        "type": "type_delivery_distance_extra",
        "total": {
          "amount": 27,
          "currency": "EUR"
        },
        "vat_percentage": 12
      },
      {
        "type": "type_delivery_distance_extra",
        "total": {
          "amount": 18,
          "currency": "EUR"
        },
        "vat_percentage": 19
      }
    ]
  },
  "items": [
    {
      "item_type": "order-item-with-price-breakdown",
      "id": "68656c6c6f6f727632646572",
      "count": 2,
      "pos_id": "SUPERHAMBURG",
      "sku": "combo",
      "gtin": null,
      "options": [
        {
          "id": "68656c6c6f6f727632646573",
          "name": "Toppings",
          "value": "Lettuce",
          "price": {
            "amount": 0,
            "currency": "EUR"
          },
          "vat_percentage": 0,
          "price_breakdown": {
            "price_before_discounts": {
              "amount": 0,
              "currency": "EUR"
            },
            "total_discounts": {
              "amount": 0,
              "currency": "EUR"
            },
            "subtotal_basket_discounts": {
              "amount": 0,
              "currency": "EUR"
            },
            "subtotal_item_discounts": {
              "amount": 0,
              "currency": "EUR"
            }
          },
          "pos_id": "toppings_added",
          "count": 1,
          "value_pos_id": "LETTUCE",
          "deposit": null
        },
        {
          "id": "68656c6c6f6f727632646574",
          "name": "Toppings",
          "value": "Tomato",
          "price": {
            "amount": 0,
            "currency": "EUR"
          },
          "vat_percentage": 0,
          "price_breakdown": {
            "price_before_discounts": {
              "amount": 0,
              "currency": "EUR"
            },
            "total_discounts": {
              "amount": 0,
              "currency": "EUR"
            },
            "subtotal_basket_discounts": {
              "amount": 0,
              "currency": "EUR"
            },
            "subtotal_item_discounts": {
              "amount": 0,
              "currency": "EUR"
            }
          },
          "pos_id": "toppings_added",
          "count": 1,
          "value_pos_id": "TOMATOSLICES",
          "deposit": null
        },
        {
          "id": "68656c6c6f6f727632646575",
          "name": "Toppings",
          "value": "Truffles",
          "price": {
            "amount": 500,
            "currency": "EUR"
          },
          "vat_percentage": 0,
          "price_breakdown": {
            "price_before_discounts": {
              "amount": 1000,
              "currency": "EUR"
            },
            "total_discounts": {
              "amount": 102,
              "currency": "EUR"
            },
            "subtotal_basket_discounts": {
              "amount": 102,
              "currency": "EUR"
            },
            "subtotal_item_discounts": {
              "amount": 0,
              "currency": "EUR"
            }
          },
          "pos_id": "toppings_added",
          "count": 1,
          "value_pos_id": "TRUF",
          "deposit": null
        },
        {
          "id": "68656c6c6f6f727632646576",
          "name": "Changes",
          "value": "Gluten-free bun",
          "price": {
            "amount": 0,
            "currency": "EUR"
          },
          "vat_percentage": 0,
          "price_breakdown": {
            "price_before_discounts": {
              "amount": 0,
              "currency": "EUR"
            },
            "total_discounts": {
              "amount": 0,
              "currency": "EUR"
            },
            "subtotal_basket_discounts": {
              "amount": 0,
              "currency": "EUR"
            },
            "subtotal_item_discounts": {
              "amount": 0,
              "currency": "EUR"
            }
          },
          "pos_id": "changes_burger",
          "count": 1,
          "value_pos_id": "GLT_FREE_BUN",
          "deposit": null
        },
        {
          "id": "68656c6c6f6f727632646577",
          "name": "Changes",
          "value": "No Pickles",
          "price": {
            "amount": 0,
            "currency": "EUR"
          },
          "vat_percentage": 0,
          "price_breakdown": {
            "price_before_discounts": {
              "amount": 0,
              "currency": "EUR"
            },
            "total_discounts": {
              "amount": 0,
              "currency": "EUR"
            },
            "subtotal_basket_discounts": {
              "amount": 0,
              "currency": "EUR"
            },
            "subtotal_item_discounts": {
              "amount": 0,
              "currency": "EUR"
            }
          },
          "pos_id": "changes_burger",
          "count": 1,
          "value_pos_id": "REMOVE_PICKLES",
          "deposit": null
        }
      ],
      "item_price": {
        "unit_price": {
          "amount": 2154,
          "currency": "EUR"
        },
        "base_price": {
          "amount": 2290,
          "currency": "EUR"
        },
        "vat_percentage": 0,
        "total": {
          "amount": 4308,
          "currency": "EUR"
        },
        "price_breakdown": {
          "total_before_discounts": {
            "amount": 4800,
            "currency": "EUR"
          },
          "total_discounts": {
            "amount": 492,
            "currency": "EUR"
          },
          "subtotal_basket_discounts": {
            "amount": 390,
            "currency": "EUR"
          },
          "subtotal_item_discounts": {
            "amount": 0,
            "currency": "EUR"
          },
          "base_price_before_discounts": {
            "amount": 1900,
            "currency": "EUR"
          },
          "unit_price_before_discounts": {
            "amount": 2400,
            "currency": "EUR"
          },
          "subtotal_options_basket_discounts": {
            "amount": 102,
            "currency": "EUR"
          },
          "subtotal_options_item_discounts": {
            "amount": 0,
            "currency": "EUR"
          }
        }
      },
      "name": "Super Hamburger test",
      "category": {
        "id": "65043e12d6d9cb60a18b89ac",
        "name": "Burgers"
      },
      "deposit": null,
      "is_bundle_offer": false
    },
    {
      "item_type": "order-item-with-price-breakdown",
      "id": "68656c6c6f6f727632646562",
      "count": 5,
      "pos_id": "123",
      "sku": "123",
      "gtin": null,
      "options": [],
      "item_price": {
        "unit_price": {
          "amount": 123,
          "currency": "EUR"
        },
        "base_price": {
          "amount": 706,
          "currency": "EUR"
        },
        "vat_percentage": 7,
        "total": {
          "amount": 619,
          "currency": "EUR"
        },
        "price_breakdown": {
          "total_before_discounts": {
            "amount": 1125,
            "currency": "EUR"
          },
          "total_discounts": {
            "amount": 506,
            "currency": "EUR"
          },
          "subtotal_basket_discounts": {
            "amount": 56,
            "currency": "EUR"
          },
          "subtotal_item_discounts": {
            "amount": 450,
            "currency": "EUR"
          },
          "base_price_before_discounts": {
            "amount": 200,
            "currency": "EUR"
          },
          "unit_price_before_discounts": {
            "amount": 225,
            "currency": "EUR"
          },
          "subtotal_options_basket_discounts": {
            "amount": 0,
            "currency": "EUR"
          },
          "subtotal_options_item_discounts": {
            "amount": 0,
            "currency": "EUR"
          }
        }
      },
      "name": "coca cola test",
      "category": {
        "id": "68656c6c6f6f727632646563",
        "name": "Drinks"
      },
      "deposit": {
        "gross_price": {
          "amount": 25,
          "currency": "EUR"
        },
        "net_price": {
          "amount": 22,
          "currency": "EUR"
        },
        "vat_percentage": 16
      },
      "is_bundle_offer": false
    }
  ],
  "created_at": "2024-01-01T12:00:00.000Z",
  "consumer_comment": null,
  "consumer_name": "Yuho",
  "consumer_phone_number": "+3581234567",
  "pickup_eta": "2024-01-01T12:00:10Z",
  "attribution_id": null,
  "type": "instant",
  "pre_order": null,
  "order_number": "10",
  "order_status": "delivered",
  "modified_at": "2024-01-01T12:00:20.000Z",
  "company_tax_id": null,
  "loyalty_card_number": null,
  "cash_payment": null
}

Get order V2

This operation requires Bearer authentication.

Retrieve an order in Order V2 format by order ID which you receive in the order notification.

Parameters

orderIdstring

Required. Unique identifier for the order.

Responses

GET /v2/orders/{orderId}

curl https://pos-integration-service.wolt.com/v2/orders/{orderId} \
  -H "Authorization: Bearer {{access_token}}"

Response

HTTP/1.1 200 OK

{
  "id": "string",
  "venue": {
    "id": "string",
    "name": "string",
    "external_venue_id": "string"
  },
  "basket_price": {
    "total": {
      "amount": 0,
      "currency": "string"
    },
    "price_breakdown": {
      "total_before_discounts": {
        "amount": 0,
        "currency": "string"
      },
      "total_discounts": {
        "amount": 0,
        "currency": "string"
      },
      "subtotal_basket_discounts": {
        "amount": 0,
        "currency": "string"
      },
      "subtotal_item_discounts": {
        "amount": 0,
        "currency": "string"
      }
    }
  },
  "delivery": {
    "status": "delivered",
    "type": "homedelivery",
    "time": "2024-01-01T12:00:00.000Z",
    "location": {
      "street_address": "string",
      "apartment": "string",
      "city": "string",
      "country": "string",
      "coordinates": {
        "lon": 0,
        "lat": 0
      },
      "formatted_address": "string"
    },
    "self_delivery": true
  },
  "fees": {
    "total": {
      "amount": 0,
      "currency": "string"
    },
    "price_breakdown": {
      "total_before_discounts": {
        "amount": 0,
        "currency": "string"
      },
      "total_discounts": {
        "amount": 0,
        "currency": "string"
      },
      "liability": {
        "amount": 0,
        "currency": "string"
      }
    },
    "parts": [
      {
        "type": "DELIVERY_FEES",
        "total": {
          "amount": 1400,
          "currency": "EUR"
        }
      }
    ]
  },
  "items": [
    {
      "item_type": "order-item",
      "id": "string",
      "count": 0,
      "pos_id": "string",
      "sku": "string",
      "gtin": "string",
      "options": [
        {
          "id": "string",
          "name": "string",
          "value": "string",
          "price": {
            "amount": 0,
            "currency": "string"
          },
          "vat_percentage": 0,
          "price_breakdown": {
            "price_before_discounts": {
              "amount": 0,
              "currency": "string"
            },
            "total_discounts": {
              "amount": 0,
              "currency": "string"
            },
            "subtotal_basket_discounts": {
              "amount": 0,
              "currency": "string"
            },
            "subtotal_item_discounts": {
              "amount": 0,
              "currency": "string"
            }
          },
          "pos_id": "string",
          "count": 0,
          "value_pos_id": "string",
          "deposit": {
            "gross_price": {
              "amount": 0,
              "currency": "string"
            },
            "net_price": {
              "amount": 0,
              "currency": "string"
            },
            "vat_percentage": 0
          }
        }
      ],
      "item_price": {
        "unit_price": {
          "amount": 0,
          "currency": "string"
        },
        "base_price": {
          "amount": 0,
          "currency": "string"
        },
        "vat_percentage": 0,
        "total": {
          "amount": 0,
          "currency": "string"
        },
        "price_breakdown": {
          "total_before_discounts": {
            "amount": 0,
            "currency": "string"
          },
          "total_discounts": {
            "amount": 0,
            "currency": "string"
          },
          "subtotal_item_discounts": {
            "amount": 0,
            "currency": "string"
          },
          "base_price_before_discounts": {
            "amount": 0,
            "currency": "string"
          },
          "unit_price_before_discounts": {
            "amount": 0,
            "currency": "string"
          },
          "subtotal_options_basket_discounts": {
            "amount": 0,
            "currency": "string"
          },
          "subtotal_options_item_discounts": {
            "amount": 0,
            "currency": "string"
          }
        }
      },
      "name": "string",
      "category": {
        "id": "string",
        "name": "string"
      },
      "deposit": {
        "gross_price": {
          "amount": 0,
          "currency": "string"
        },
        "net_price": {
          "amount": 0,
          "currency": "string"
        },
        "vat_percentage": 0
      },
      "is_bundle_offer": true,
      "row_number": 0,
      "substitution_settings": {
        "is_allowed": true,
        "comment": "string"
      },
      "weight_details": {
        "weight_in_grams": 0,
        "requested_amount": 0,
        "extra_weight_percentage": 0
      }
    }
  ],
  "created_at": "2025-03-08T00:06:05.679Z",
  "consumer_comment": "string",
  "consumer_name": "string",
  "consumer_phone_number": "string",
  "pickup_eta": "2025-03-08T00:06:05.679Z",
  "attribution_id": "string",
  "type": "preorder",
  "pre_order": {
    "preorder_time": "2025-03-08T00:06:05.679Z",
    "pre_order_status": "confirmed"
  },
  "order_number": "string",
  "order_status": "received",
  "modified_at": "2024-01-01T12:00:00Z",
  "company_tax_id": "string",
  "loyalty_card_number": "string",
  "cash_payment": {
    "cash_amount": {
      "amount": 0,
      "currency": "string"
    },
    "cash_to_expect": {
      "amount": 0,
      "currency": "string"
    },
    "total_paid_by_other_methods": {
      "amount": 0,
      "currency": "string"
    }
  },
  "merchant": {
    "id": "string"
  }
}

Order

Order object describes an order on Wolt.

Endpoints

get/orders/{orderId}put/orders/{orderId}/accept put/orders/{orderId}/self-delivery/accept put/orders/{orderId}/reject put/orders/{orderId}/ready put/orders/{orderId}/delivered put/orders/{orderId}/confirm-preorder put/orders/{orderId}/replace-items put/orders/{orderId}/sent-to-pos

The Order object

Properties

idstring

Unique identifier for the order.

venueobject

Details of the venue where the order was placed.

priceobject

Total price of the order.

deliveryobject

The delivery method of the order.

items[object]

Items included in the order.

created_atstring

The date and time (ISO 8601 format) when the order was received by Wolt's system.

consumer_commentstringnullable

Comment added to the order by consumer.

When making an order using Wolt app, a consumer can leave a message to the restaurant. For example to inform the kitchen about dietary restrictions.

pickup_etastring

The date and time (ISO 8601 format) when the courier is expected to pick up the order.

attribution_idstring

Unique identifier for the attribution.

typestringenum: preorder, instant

An order can be of two different types.

instant: When an order is to be fulfilled instantly.
preorder: When a consumer schedules an order.

pre_orderobjectnullable

Pre-order details for the order.

consumer_namestring

Name of the consumer who made the order.

If a self-delivery venue has full name setting enabled they will receive the full name of the consumer, otherwise the name will include only first name and first letter of last name.

consumer_phone_numberstringnullable

Phone number of the consumer who made the order.

order_numberstring

A human readable order number that is unique only for open orders. Order numbers can repeat and are not unique for a venue.

order_statusstringenum: received, fetched, acknowledged, production, ready, delivered, rejected, other

Status of the order. An order progresses through a life cycle that consists of different states:

received: The order was fetched by the Wolt Merchant app and/or acknowledged by venue staff on the app.
fetched: The order was fetched in the Wolt Merchant app.
acknowledged: The order was interacted by venue staff on the Wolt Merchant app.
production: Preparation of the order has started.
ready: The order has been prepared and is awaiting delivery.
delivered: The order has been delivered to the consumer.
rejected: The venue or Wolt's system rejected the order.
refunded: Wolt has processed a refund for the order.
other: Other unknown status.

modified_atstring

The date and time (ISO 8601 format) when the order was last modified.

Orders move through a life cycle and can change the order status. This change is also considered a modification, so the date and time could be the time when a purchase changed its status from acknowledged to production.

company_tax_idstringnullable

Unique identifier for company tax.

In some markets, consumers are allowed to bill their company for the purchase. In these situations they input the company's tax ID and this information is passed on for accounting purposes.

loyalty_card_numberstringnullable

Loyalty card number given by consumer during checkout from a retail venue.

This can be only used to add points for the consumer based on the purchase. No validation of this number takes place in Wolt's system.

cash_paymentobject

Contains information about cash payment of the order.

With this information the courier will be able to request correct amount of cash from the customer and also reserve enough change in case customer does not have even amount in cash.

merchantobjectnullable

Contains information about the merchant who is responsible for the order.

This is relevant only for self-delivery venues.

Order object example

{
  "id": "62db996d7706bd423bb10db6",
  "venue": {
    "id": "602fb85a64983ea30328f131",
    "name": "Burger Venue",
    "external_venue_id": "5"
  },
  "price": {
    "amount": 24200,
    "currency": "EUR"
  },
  "delivery": {
    "status": "delivered",
    "type": "homedelivery",
    "time": "2021-06-14T12:07:19.812Z",
    "fee": {
      "amount": 1000,
      "currency": "EUR"
    },
    "location": {
      "street_address": "Mannerheimintie 1",
      "apartment": "C 2",
      "city": "Helsinki",
      "country": "Finland",
      "coordinates": {
        "lon": 53.390234,
        "lat": -7.782839
      },
      "formatted_address": "Mannerheimintie 1 C 2, 00100, Helsinki\nDrive past the big rock to see the entrance.\nLeave parcel to entrance.\nDoor code: 1234\n"
    },
    "small_order_surcharge": {
      "amount": 10,
      "currency": "EUR"
    },
    "self_delivery": false
  },
  "items": [
    {
      "id": "602fb890e765db64dc152203",
      "item_type": "order-item",
      "count": 1,
      "pos_id": "1623629",
      "sku": "4232134",
      "gtin": "00369545276326",
      "options": [
        {
          "id": "602fb890e765db64dc152196",
          "name": "In the burger",
          "value": "Cheese",
          "price": {
            "amount": 1000,
            "currency": "EUR"
          },
          "pos_id": null,
          "count": 1,
          "value_pos_id": "1623576"
        },
        {
          "id": "602fb890e765db64dc1521ca",
          "name": "Side",
          "value": "Fries",
          "price": {
            "amount": 0,
            "currency": "EUR"
          },
          "pos_id": "1623560",
          "count": 1,
          "value_pos_id": "1623560"
        },
        {
          "id": "602fb890e765db64dc15219e",
          "name": "Dips",
          "value": "Bearnaise",
          "price": {
            "amount": 200,
            "currency": "EUR"
          },
          "pos_id": null,
          "count": 1,
          "value_pos_id": "1623555"
        },
        {
          "id": "602fb890e765db64dc15219c",
          "name": "Dips",
          "value": "Chipotle Mayo",
          "price": {
            "amount": 0,
            "currency": "EUR"
          },
          "pos_id": null,
          "count": 1,
          "value_pos_id": "1623553"
        },
        {
          "id": "602fb890e765db64dc1521af",
          "name": "Extras sides",
          "value": "Real Nuggets (4 stk)",
          "price": {
            "amount": 5000,
            "currency": "EUR"
          },
          "pos_id": null,
          "count": 1,
          "value_pos_id": "1623634"
        },
        {
          "id": "602fb890e765db64dc1521b0",
          "name": "Extras sides",
          "value": "Spicy Hotdog",
          "price": {
            "amount": 4000,
            "currency": "EUR"
          },
          "pos_id": null,
          "count": 1,
          "value_pos_id": "1623635",
          "deposit": {
            "gross_price": {
              "amount": 40,
              "currency": "EUR"
            },
            "net_price": {
              "amount": 30,
              "currency": "EUR"
            },
            "vat_percentage": 15
          }
        },
        {
          "id": "602fb890e765db64dc1521a9",
          "name": "Sodas",
          "value": "Lemon Soda 0,33 l",
          "price": {
            "amount": 0,
            "currency": "EUR"
          },
          "pos_id": null,
          "count": 1,
          "value_pos_id": "1623532"
        }
      ],
      "total_price": {
        "amount": 24200,
        "currency": "EUR"
      },
      "base_price": {
        "amount": 14000,
        "currency": "EUR"
      },
      "unit_price": {
        "amount": 24200,
        "currency": "EUR"
      },
      "name": "Fried Chicken Burger Combo",
      "category": {
        "id": "5bf00d226feade000a37266e",
        "name": "Combos"
      },
      "deposit": {
        "gross_price": {
          "amount": 2400,
          "currency": "EUR"
        },
        "net_price": {
          "amount": 2200,
          "currency": "EUR"
        },
        "vat_percentage": 15
      },
      "is_bundle_offer": false
    }
  ],
  "created_at": "2021-05-05T10:19:38.856Z",
  "consumer_comment": "Don't forget the ketchup please!",
  "pickup_eta": "2021-05-05T10:25:09.636Z",
  "attribution_id": "123456789",
  "type": "instant",
  "pre_order": {
    "preorder_time": "2021-05-05T10:22:16.631Z",
    "pre_order_status": "confirmed"
  },
  "consumer_name": "Frank L",
  "consumer_phone_number": "+35850111222333",
  "order_number": "485",
  "order_status": "delivered",
  "modified_at": "2021-05-05T10:22:16.631Z",
  "company_tax_id": "TXN 123 999",
  "loyalty_card_number": "loyalty-card-number",
  "cash_payment": {
    "cash_amount": {
      "amount": 200,
      "currency": "EUR"
    },
    "cash_to_expect": {
      "amount": 300,
      "currency": "EUR"
    }
  },
  "merchant": {
    "id": "21312"
  }
}

Get order

This operation requires Bearer authentication.

Retrieve an order by order ID which you receive in the order notification.

Parameters

orderIdstring

Required. Unique identifier for the order.

Responses

GET /orders/{orderId}

curl https://pos-integration-service.wolt.com/orders/{orderId} \
  -H "Authorization: Bearer {{access_token}}"

Response

HTTP/1.1 200 OK

{
  "id": "string",
  "venue": {
    "id": "string",
    "name": "string",
    "external_venue_id": "string"
  },
  "price": {
    "amount": 0,
    "currency": "string"
  },
  "delivery": {
    "status": "estimated",
    "type": "takeaway",
    "time": "2025-03-08T00:06:05.679Z",
    "fee": {
      "amount": 0,
      "currency": "string"
    },
    "location": {
      "street_address": "string",
      "apartment": "string",
      "city": "string",
      "country": "string",
      "coordinates": {
        "lon": 0,
        "lat": 0
      },
      "formatted_address": "string"
    },
    "small_order_surcharge": {
      "amount": 0,
      "currency": "string"
    },
    "self_delivery": true
  },
  "items": [
    {
      "id": "string",
      "name": "string",
      "count": 0,
      "options": [
        {
          "id": "string",
          "name": "string",
          "value": "string",
          "price": {
            "amount": 0,
            "currency": "string"
          },
          "pos_id": "string",
          "count": 0,
          "value_pos_id": "string",
          "deposit": {
            "gross_price": {
              "amount": 0,
              "currency": "string"
            },
            "net_price": {
              "amount": 0,
              "currency": "string"
            },
            "vat_percentage": 0
          }
        }
      ],
      "category": {
        "id": "string",
        "name": "string"
      },
      "deposit": {
        "gross_price": {
          "amount": 0,
          "currency": "string"
        },
        "net_price": {
          "amount": 0,
          "currency": "string"
        },
        "vat_percentage": 0
      },
      "row_number": 0,
      "substitution_settings": {
        "is_allowed": true,
        "comment": "string"
      },
      "total_price": {
        "amount": 0,
        "currency": "string"
      },
      "unit_price": {
        "amount": 0,
        "currency": "string"
      },
      "base_price": {
        "amount": 0,
        "currency": "string"
      },
      "weight_details": {
        "weight_in_grams": 0,
        "requested_amount": 0,
        "extra_weight_percentage": 0
      },
      "sku": "string",
      "gtin": "string",
      "pos_id": "string",
      "item_type": "order-item"
    }
  ],
  "created_at": "2025-03-08T00:06:05.679Z",
  "consumer_comment": "string",
  "pickup_eta": "2025-03-08T00:06:05.679Z",
  "attribution_id": "string",
  "type": "preorder",
  "pre_order": {
    "preorder_time": "2025-03-08T00:06:05.679Z",
    "pre_order_status": "confirmed"
  },
  "consumer_name": "string",
  "consumer_phone_number": "string",
  "order_number": "string",
  "order_status": "received",
  "modified_at": "2025-03-08T00:06:05.679Z",
  "company_tax_id": "string",
  "loyalty_card_number": "string",
  "cash_payment": {
    "cash_amount": {
      "amount": 0,
      "currency": "string"
    },
    "cash_to_expect": {
      "amount": 0,
      "currency": "string"
    }
  },
  "merchant": {
    "id": "string"
  }
}

Accept order

This operation requires Bearer authentication.

Accepts the order and changes its status to production in Wolt's system.

Parameters

orderIdstring

Required. Unique identifier for the order.

Properties

adjusted_pickup_timestring

The date and time (ISO 8601 format) when the order should be picked up in case the current pickup time is too early for the venue to prepare the order.

The adjusted pickup time cannot be greater than 25 minutes from the initial calculated pickup time estimate.

Responses

PUT /orders/{orderId}/accept

curl -X PUT https://pos-integration-service.wolt.com/orders/{orderId}/accept \
  -H 'Content-Type: application/json' \
  -H "Authorization: Bearer {{access_token}}" \
  -d '{"adjusted_pickup_time":"2021-05-05T10:22:16.631Z"}'

Response

HTTP/1.1 202 Accepted

Accept self-delivery order

This operation requires Bearer authentication.

Accepts the self-delivery order and changes status of order to production.

Parameters

orderIdstring

Required. Unique identifier for the order.

Properties

total_delivery_timestring

The date and time (ISO 8601 format) when the self-delivery order is expected to be delivered to the consumer.

If not provided, the venue's default order preparation and order delivery time will be used instead.

Responses

PUT /orders/{orderId}/self-delivery/accept

curl -X PUT https://pos-integration-service.wolt.com/orders/{orderId}/self-delivery/accept \
  -H 'Content-Type: application/json' \
  -H "Authorization: Bearer {{access_token}}" \
  -d '{"total_delivery_time":"2022-03-29T13:16:00Z"}'

Response

HTTP/1.1 202 Accepted

Reject order

This operation requires Bearer authentication.

Rejects the order and changes its status to rejected in Wolt's system. The given rejection reason is shown to the consumer.

Parameters

orderIdstring

Required. Unique identifier for the order.

Properties

reasonstring

Required. Reason for rejecting the order.

Rejection reason will be shown to the consumer. You should use local language and consumer friendly tone.

codestringnullableenum: GENERIC, ITEMS_UNAVAILABLE, VENUE_CLOSING_SOON

Pre-defined rejection key.

GENERIC is the default value.
ITEMS_UNAVAILABLE is used when the request item is out of stock.
VENUE_CLOSING_SOON is used when the venue is closing soon.

Responses

PUT /orders/{orderId}/reject

curl -X PUT https://pos-integration-service.wolt.com/orders/{orderId}/reject \
  -H 'Content-Type: application/json' \
  -H "Authorization: Bearer {{access_token}}" \
  -d '{"reason":"Out of stock"}'

Response

HTTP/1.1 202 Accepted

Mark order ready

This operation requires Bearer authentication.

Marks the order as ready in Wolt's system.

Takeaway orders must be marked as ready before they can be picked up by the consumer.

Parameters

orderIdstring

Required. Unique identifier for the order.

Responses

PUT /orders/{orderId}/ready

curl -X PUT https://pos-integration-service.wolt.com/orders/{orderId}/ready \
  -H "Authorization: Bearer {{access_token}}"

Response

HTTP/1.1 202 Accepted

Mark order delivered

This operation requires Bearer authentication.

Marks the order as delivered in Wolt's system.

Takeaway orders must be marked as delivered after they have been picked up by the consumer.

Parameters

orderIdstring

Required. Unique identifier for the order.

Responses

PUT /orders/{orderId}/delivered

curl -X PUT https://pos-integration-service.wolt.com/orders/{orderId}/delivered \
  -H "Authorization: Bearer {{access_token}}"

Response

HTTP/1.1 202 Accepted

Confirm pre-order

This operation requires Bearer authentication.

Confirm a pre-order to accept it. Confirmed pre-orders are automatically moved to production state based on venue's preparation time.

Parameters

orderIdstring

Required. Unique identifier for the order.

Responses

PUT /orders/{orderId}/confirm-preorder

curl -X PUT https://pos-integration-service.wolt.com/orders/{orderId}/confirm-preorder \
  -H "Authorization: Bearer {{access_token}}"

Response

HTTP/1.1 204 No Content

Replace order items

This operation requires Bearer authentication.

Replace items in an order. For example substitute item with another, change weight of an item or mark item as missing.

This endpoint can be called only once per order. You must ensure that you call it only after all changes are made.

Parameters

orderIdstring

Required. Unique identifier for the order.

Properties

item_changes[object]

Required. Changes done to items in order during picking progress.

Responses

PUT /orders/{orderId}/replace-items

curl -X PUT https://pos-integration-service.wolt.com/orders/{orderId}/replace-items \
  -H 'Content-Type: application/json' \
  -H "Authorization: Bearer {{access_token}}" \
  -d '{"item_changes":[{"row_number":0,"replacement_items":[{"replacement_type":"count-change-replacement","barcode":"string","count":0,"name":"string","price":{"amount":0,"currency":"string"},"purchase_item_id":"string","weight":0}]}]}'

Response

HTTP/1.1 202 Accepted

Mark order sent to POS

This operation requires Bearer authentication.

Marks the order as sent to the POS system. This is used to indicate that the order has been sent to the POS and the POS has received it.

Parameters

orderIdstring

Required. Unique identifier for the order.

Properties

successboolean

Required. Informs if the order was successfully marked as sent to the POS system.

time_sent_to_posstring

Required. The date and time (ISO 8601 format) the order has been sent to the POS system.

Responses

PUT /orders/{orderId}/sent-to-pos

curl -X PUT https://pos-integration-service.wolt.com/orders/{orderId}/sent-to-pos \
  -H 'Content-Type: application/json' \
  -H "Authorization: Bearer {{access_token}}" \
  -d '{"success":true,"time_sent_to_pos":"2021-05-05T10:22:16.631Z"}'

Response

HTTP/1.1 202 Accepted