IntroductionAuthenticationSelecting dataFilteringSorting & pagination

Core resources

Api requestsAttribute optionsAttributesBooking detailsBooking updatesBookingsCalendar event notesCalendar event updatesCalendar eventsCapacitiesCapacity group dependenciesCapacity groupsContact bookingsContactsCoupon productsCoupon servicesCoupon usesCouponsExternal calendarsInvoicesLine item taxesLine itemsMembersMessage eventsMessage templatesMessagesOrganization calendar logsOrganizationsPaddle plansPaddle subscriptionsPaymentsPermissionsPrice calendar entriesPricelabs pricingPricing widgetsProduct attribute optionsProduct calendar logsProduct message templatesProduct reply to addressesProduct servicesProductsRefundsReply to addressesReview productsReview widget listingsReview widgetsReviewsSeasonsServicesSite listingsSite nav itemsSite pagesSite viewsSitesTask assigneesTask template assigneesTask templatesTasksTaxesUser profilesWebhook notificationsWebhooksWidget analyticsWidget listings
The widget listing objectList widget listingsCreate widget listingsDelete widget listingsUpdate widget listings
Widgets

Booking flow

Query availabilitySearch availabilityBook

Widget listings

Units listed in a widget

Endpoints
GET/widget_listingsPOST/widget_listingsDELETE/widget_listingsPATCH/widget_listings

The widget listing object

Attributes

iduuid

Unique identifier

product_iduuid
products.id

Identifier of the related unit

widget_iduuid
widgets.id

Identifier of the related widget

created_attimestamp with time zone

Creation timestamp

updated_attimestamp with time zone

Last modification timestamp

ordersmallint

Order of the listing as displayed in the widget

urlMultiLanguageString

URL of the listing. Only applies when widget.interaction is forward

The widget listing object

JSON

{
  "id": "00000000-0000-0000-0000-000000000000",
  "product_id": "00000000-0000-0000-0000-000000000000",
  "widget_id": "00000000-0000-0000-0000-000000000000",
  "created_at": "2026-03-12T04:02:28.654Z",
  "updated_at": "2026-03-12T04:02:28.654Z",
  "order": 0,
  "url": {
    "default": "Hello",
    "nl-NL": "Hallo"
  }
}

List widget listings

Filters

idFilter<uuid>

Unique identifier

product_idFilter<uuid>
products.id

Identifier of the related unit

widget_idFilter<uuid>
widgets.id

Identifier of the related widget

created_atFilter<timestamp with time zone>

Creation timestamp

updated_atFilter<timestamp with time zone>

Last modification timestamp

orderFilter<smallint>

Order of the listing as displayed in the widget

urlFilter<MultiLanguageString>

URL of the listing. Only applies when widget.interaction is forward

Responses

200

A list of widget listings with the selected columns

206

Partial Content

GET /widget_listings
curl -X GET "https://api.bookingmood.com/v1/widget_listings?select=*" \
  -H "Authorization: Bearer YOUR_API_KEY"

Create widget listings

Body

Partial<WidgetListing> | Array<Partial<WidgetListing>>

Responses

201

The newly created widget listings with the selected columns

POST /widget_listings
curl -X POST "https://api.bookingmood.com/v1/widget_listings" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '[]'

Delete widget listings

Filters

idFilter<uuid>

Unique identifier

product_idFilter<uuid>
products.id

Identifier of the related unit

widget_idFilter<uuid>
widgets.id

Identifier of the related widget

created_atFilter<timestamp with time zone>

Creation timestamp

updated_atFilter<timestamp with time zone>

Last modification timestamp

orderFilter<smallint>

Order of the listing as displayed in the widget

urlFilter<MultiLanguageString>

URL of the listing. Only applies when widget.interaction is forward

Responses

204

The deleted widget listings with the selected columns

DELETE /widget_listings
curl -X DELETE "https://api.bookingmood.com/v1/widget_listings" \
  -H "Authorization: Bearer YOUR_API_KEY"

Update widget listings

Filters

idFilter<uuid>

Unique identifier

product_idFilter<uuid>
products.id

Identifier of the related unit

widget_idFilter<uuid>
widgets.id

Identifier of the related widget

created_atFilter<timestamp with time zone>

Creation timestamp

updated_atFilter<timestamp with time zone>

Last modification timestamp

orderFilter<smallint>

Order of the listing as displayed in the widget

urlFilter<MultiLanguageString>

URL of the listing. Only applies when widget.interaction is forward

Body

Partial<WidgetListing>

Responses

204

The updated widget listings with the selected columns

PATCH /widget_listings
curl -X PATCH "https://api.bookingmood.com/v1/widget_listings" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{}'