Search.../
  1. Home
  2. Getting Started
  3. Overview
Generate a test token to explore our APIs

List Services

Developer Preview

Lists all services in the business

Permissions This endpoint requires the Read Bookings - Public Data or Read Bookings - Including Participants permissions scope

Authorization

This endpoint requires an authorization header - pass the access token from the OAuth installation flow.

GET

https://www.wixapis.com/bookings/v1/services

Query Params

NAME
TYPE
DESCRIPTION
includeDeleted

boolean

Optional. Default is false

Response Object

NAME
TYPE
DESCRIPTION
services

Array<object>

List of all retrieved services

Status/Error Codes

The response will include an HTTP status code.

Was this helpful?

List Services

Returns all the services in the site.

Request

curl

Copy Code
1curl -X GET \
2 'https://www.wixapis.com/bookings/v1/services' \
3 -H 'Authorization: <AUTH>'

Response

json

1
2{"services": [
3 {
4 "id": "4c0bae61-4599-4d02-a2f4-25e9222df416",
5 "info": {
6 "name": "Haircut",
7 "description": "A regular short haircut",
8 "images": [ {
9 "id": "bd10eec5-564a-47b7-8638-ff005f18261d",
10 "url": "bd10eec5564a47b78638ff005f18261d.jpg",
11 "height": 4912,
12 "width": 7360
13 }],
14 "tagLine": "A regular Haircut"
15 },
16 "policy": {
17 "maxParticipantsPerBooking": 1,
18 "bookUpToXMinutesBefore": 1440,
19 "cancelRescheduleUpToXMinutesBefore": 61,
20 "isBookOnlineAllowed": true,
21 "isCancelAllowed": true,
22 "isRescheduleAllowed": true,
23 "futureBookingsPolicy": {
24 "shouldLimit": false,
25 "limitXMinutesToTheFuture": 1440
26 },
27 "waitingListPolicy": {
28 "isEnabled": false,
29 "capacity": 10,
30 "timeWindowMinutes": 10
31 },
32 "bookingsApprovalPolicy": {
33 "isBusinessApprovalRequired": false,
34 "requestsAffectsAvailability": true
35 }
36 },
37 "paymentOptions": {
38 "wixPayOnline": true,
39 "wixPayInPerson": false,
40 "custom": false,
41 "wixPaidPlan": false
42 },
43 "categoryId": "442d101a-37b1-4769-81e5-4e7f809585e8",
44 "bookingFormId": "00000000-0000-0000-0000-000000000000",
45 "scheduleIds": ["a93abaf4-c776-46d2-aba0-c986c40ae8c1"],
46 "customProperties": {
47 "order": "10",
48 "uouHidden": "false"
49 },
50 "status": "CREATED",
51 "sortOrder": 10
52 },
53 {
54 "id": "5228133b-f86b-453c-a400-ffe7f80e1996",
55 "info": {
56 "name": "Beard Trimming",
57 "description": "A description here...",
58 "images": [ {
59 "id": "97e41887-1440-4474-8ae9-8d8d7b60abb6",
60 "url": "97e41887144044748ae98d8d7b60abb6.jpg",
61 "height": 1086,
62 "width": 1920
63 }],
64 "tagLine": "Trim Your Beard"
65 },
66 "policy": {
67 "maxParticipantsPerBooking": 1,
68 "bookUpToXMinutesBefore": 1440,
69 "cancelRescheduleUpToXMinutesBefore": 61,
70 "isBookOnlineAllowed": true,
71 "isCancelAllowed": true,
72 "isRescheduleAllowed": true,
73 "futureBookingsPolicy": {
74 "shouldLimit": false,
75 "limitXMinutesToTheFuture": 1440
76 },
77 "waitingListPolicy": {
78 "isEnabled": false,
79 "capacity": 10,
80 "timeWindowMinutes": 10
81 },
82 "bookingsApprovalPolicy": {
83 "isBusinessApprovalRequired": false,
84 "requestsAffectsAvailability": true
85 }
86 },
87 "paymentOptions": {
88 "wixPayOnline": true,
89 "wixPayInPerson": false,
90 "custom": false,
91 "wixPaidPlan": false
92 },
93 "categoryId": "442d101a-37b1-4769-81e5-4e7f809585e8",
94 "bookingFormId": "00000000-0000-0000-0000-000000000000",
95 "scheduleIds": ["4f5a5370-6756-4004-bd9c-ba021fc8e8a7"],
96 "customProperties": {
97 "order": "11",
98 "uouHidden": "false"
99 },
100 "status": "CREATED",
101 "sortOrder": 11
102 }
103]}