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 Timeslot Orders Timeslot Orders object

Timeslot Orders

Endpoints

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

The Timeslot Orders 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
      }
    }
  ]
}