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

Get Venue Status

Use this endpoint for the following information:

1. Display live venue status (online/offline)

2. Detect if action is needed to bring venue back online

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

GET /venues/{venueId}/status

{
  "external_venue_id": "string",
  "status": {
    "is_open": true,
    "is_online": true,
    "is_ipad_free": true
  },
  "contact_details": {
    "address": "string",
    "phone": "string"
  },
  "opening_times": [
    {
      "opening_day": "MONDAY",
      "opening_time": "string",
      "closing_day": "MONDAY",
      "closing_time": "string"
    }
  ],
  "special_times": [
    {
      "opening_date": "2025-08-24",
      "opening_time": "00:00",
      "closing_date": "2025-08-24",
      "closing_time": "24:00"
    }
  ],
  "delivery_area": [
    {
      "lat": 0,
      "lng": 0
    }
  ],
  "last_three_orders_status": [
    "RECEIVED"
  ]
}

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

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.

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"}]}'

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).

**Request example: PUT SPECIAL TIMES REQUEST does break the pageWIP**

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.

**Request example: PATCH Delivery Provider does break the pageWIP**

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.