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.development.dev.woltapi.com

On this page

Summary Authentication TimeSlots TimeSlots 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.

TimeSlots

Endpoints

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

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

This operation requires Bearer authentication.

Parameters

venueIdstring

Required. Unique identifier for the venue.

Responses

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

curl https://pos-integration-service.development.dev.woltapi.com/v1/venues/{venueId}/time-slots \
  -H "Authorization: Bearer {{access_token}}"

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

This operation requires Bearer authentication.

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/{venueId}/time-slots

curl -X PATCH https://pos-integration-service.development.dev.woltapi.com/v1/venues/{venueId}/time-slots \
  -H 'Content-Type: application/json' \
  -H "Authorization: Bearer {{access_token}}" \
  -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
      }
    }
  ]
}