Venue Guide

Wolt’s Venue API allows partners to monitor and manage key operational settings (like online status and opening hours) directly from a POS or back office system.

Capabilities Overview

1. Get Venue Status

Use this endpoint to:

• Display live venue status (online/offline)

• Detect if action is needed to bring venue back online

• Monitor the 3 latest order statuses to identify rejected or problematic orders

GET https://pos-integration-service.wolt.com/venues/{{venue_id}}/status

Authorization: Bearer {{access_token}}

Use case: Feed this data into your dashboards to monitor venue health in real time.

2. Set Venue Online or Offline

Toggle a venue's availability directly via API.

PATCH /venues/{{venue_id}}/status

{
  "is_online": false,
  "reason": "POS down for maintenance"
}

Refer to our API reference for more information.

3. Update Venue Opening Times

Keep Wolt’s operational hours aligned with your POS or back office schedule.

PUT https://pos-integration-service.wolt.com/venues/{{venue_id}}/opening-hours

Authorization: Bearer {{access_token}}

Content-Type: application/json

Payload Example:

PATCH /venues/{venueId}/opening-times

curl -X PATCH {{host}}/venues/{venueId}/opening-times \
  -H "Authorization: Bearer {{access_token}}" \
  -H "Content-Type: application/json" \
  -d '{"availability":[{"opening_day":"TUESDAY","opening_time":"10:30","closing_day":"TUESDAY","closing_time":"17:30"},{"opening_day":"WEDNESDAY","opening_time":"00:00","closing_day":"WEDNESDAY","closing_time":"24:00"},{"opening_day":"SATURDAY","opening_time":"10:15","closing_day":"SATURDAY","closing_time":"17:45"}]}'

4. Update Special Venue Opening Times

Keep Wolt’s operational hours aligned with your POS or back office schedule, specifically for adhoc date-specific changes (holidays, planned construction work etc).

PUT https://pos-integration-service.wolt.com/venues/{{venue_id}}/special-opening-times

Authorization: Bearer {{access_token}}

Content-Type: application/json

Payload Example:

{

 "days_closed": [

  {

   "start_date": "2027-12-25",

   "end_date": "2027-12-26",

   "message": "Closed for Christmas"

  }

 ],

 "days_open": [

  {

   "start_date": "2027-12-23",

   "end_date": "2027-12-24",

   "message": "Shortened hours for Christmas",

   "daily_availability": [

    { "open_time": "10:00", "close_time": "12:00" },

    { "open_time": "13:00", "close_time": "20:00" }

   ]

  },

  {

   "start_date": "2027-12-27",

   "end_date": "2027-12-31",

   "message": "Open for New Year",

   "daily_availability": [

    { "open_time": "00:00", "close_time": "24:00" }

   ]

  }

 ]

}

}

Best Practices

• Monitor venue health: Use recent order status signals to identify fulfillment issues early.

• Sync hours regularly: Ensure real-world hours match what’s shown in Wolt.

• Set downtime responsibly: Use the Special opening hours endpoint’s reason field when setting a venue offline to give visibility to Wolt support.

4. Hybrid delivery (change delivery provider) 

Changes the currently defined delivery provider for a venue on the Wolt marketplace.

Can be performed successfully only if the venue has hybrid delivery functionality enabled.

PATCH https://pos-integration-service.wolt.com/venues/{venueId}/delivery-provider 

Authorization: Bearer {{access_token}}

Content-Type: application/json

Payload Example:

{

  "delivery_provider": "WOLT"

}