Time slot configuration API

Time slot configuration API allows integrated partners to retrieve and update timeslots order config and effective timeslots for a venue and send them to their POS. The API must be enabled by Wolt before it can be used. You can enable it by contacting your Wolt account manager or technical account manager.

Environments

Production

Test

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

On this page

Summary TimeSlots TimeSlots object

TimeSlots

Endpoints

get/v1/venues/time-slots/{venueId}patch/v1/venues/time-slots/{venueId}

The TimeSlots object

Properties

time_slots_configurationobject

This alters the existing time slot configuration. To remove a slot, set its capacity to 0

effective_time_slots[object]

Retrieve timeslots config and effective timeslots for next 7 days for a venue

Parameters

venueIdstring

Required. Unique identifier for the venue.

Responses

GET /v1/venues/time-slots/{venueId}

curl https://pos-integration-service.wolt.com/v1/venues/time-slots/{venueId}

Response

HTTP/1.1 200 OK

{
  "time_slots_configuration": {
    "schedule": {
      "monday": [
        {
          "start": "11:00",
          "end": "12:00",
          "capacity": {
            "type": "NUMBER_OF_ORDERS",
            "maximum": 20
          }
        }
      ],
      "tuesday": [
        {
          "start": "11:00",
          "end": "12:00",
          "capacity": {
            "type": "NUMBER_OF_ORDERS",
            "maximum": 20
          }
        }
      ],
      "wednesday": [
        {
          "start": "11:00",
          "end": "12:00",
          "capacity": {
            "type": "NUMBER_OF_ORDERS",
            "maximum": 20
          }
        }
      ],
      "thursday": [
        {
          "start": "11:00",
          "end": "12:00",
          "capacity": {
            "type": "NUMBER_OF_ORDERS",
            "maximum": 20
          }
        }
      ],
      "friday": [
        {
          "start": "11:00",
          "end": "12:00",
          "capacity": {
            "type": "NUMBER_OF_ORDERS",
            "maximum": 20
          }
        }
      ],
      "saturday": [
        {
          "start": "11:00",
          "end": "12:00",
          "capacity": {
            "type": "NUMBER_OF_ORDERS",
            "maximum": 20
          }
        }
      ],
      "sunday": [
        {
          "start": "11:00",
          "end": "12:00",
          "capacity": {
            "type": "NUMBER_OF_ORDERS",
            "maximum": 20
          }
        }
      ]
    },
    "delivery_lead_time": 0
  },
  "effective_time_slots": [
    {
      "start": "2025-03-10T09:00:00Z",
      "end": "2025-03-10T09:00:00Z",
      "capacity": {
        "remaining": 0,
        "used": 0,
        "type": "NUMBER_OF_ORDERS",
        "maximum": 20
      }
    }
  ]
}

Update time slot order capacities for a venue

Parameters

venueIdstring

Required. Unique identifier for the venue.

Properties

scheduleobject

Required.

delivery_lead_timenumberminimum: 0

Required. Lead time for an order in seconds.

Responses

PATCH /v1/venues/time-slots/{venueId}

curl -X PATCH https://pos-integration-service.wolt.com/v1/venues/time-slots/{venueId} \
  -H 'Content-Type: application/json' \
  -d '{"schedule":{"monday":[{"start":"11:00","end":"12:00","capacity":{"type":"NUMBER_OF_ORDERS","maximum":20}}],"tuesday":[{"start":"11:00","end":"12:00","capacity":{"type":"NUMBER_OF_ORDERS","maximum":20}}],"wednesday":[{"start":"11:00","end":"12:00","capacity":{"type":"NUMBER_OF_ORDERS","maximum":20}}],"thursday":[{"start":"11:00","end":"12:00","capacity":{"type":"NUMBER_OF_ORDERS","maximum":20}}],"friday":[{"start":"11:00","end":"12:00","capacity":{"type":"NUMBER_OF_ORDERS","maximum":20}}],"saturday":[{"start":"11:00","end":"12:00","capacity":{"type":"NUMBER_OF_ORDERS","maximum":20}}],"sunday":[{"start":"11:00","end":"12:00","capacity":{"type":"NUMBER_OF_ORDERS","maximum":20}}]},"delivery_lead_time":0}'

Response

HTTP/1.1 200 OK

{
  "time_slots_configuration": {
    "schedule": {
      "monday": [
        {
          "start": "11:00",
          "end": "12:00",
          "capacity": {
            "type": "NUMBER_OF_ORDERS",
            "maximum": 20
          }
        }
      ],
      "tuesday": [
        {
          "start": "11:00",
          "end": "12:00",
          "capacity": {
            "type": "NUMBER_OF_ORDERS",
            "maximum": 20
          }
        }
      ],
      "wednesday": [
        {
          "start": "11:00",
          "end": "12:00",
          "capacity": {
            "type": "NUMBER_OF_ORDERS",
            "maximum": 20
          }
        }
      ],
      "thursday": [
        {
          "start": "11:00",
          "end": "12:00",
          "capacity": {
            "type": "NUMBER_OF_ORDERS",
            "maximum": 20
          }
        }
      ],
      "friday": [
        {
          "start": "11:00",
          "end": "12:00",
          "capacity": {
            "type": "NUMBER_OF_ORDERS",
            "maximum": 20
          }
        }
      ],
      "saturday": [
        {
          "start": "11:00",
          "end": "12:00",
          "capacity": {
            "type": "NUMBER_OF_ORDERS",
            "maximum": 20
          }
        }
      ],
      "sunday": [
        {
          "start": "11:00",
          "end": "12:00",
          "capacity": {
            "type": "NUMBER_OF_ORDERS",
            "maximum": 20
          }
        }
      ]
    },
    "delivery_lead_time": 0
  },
  "effective_time_slots": [
    {
      "start": "2025-03-10T09:00:00Z",
      "end": "2025-03-10T09:00:00Z",
      "capacity": {
        "remaining": 0,
        "used": 0,
        "type": "NUMBER_OF_ORDERS",
        "maximum": 20
      }
    }
  ]
}