Core resources


Administration


Booking flow

Products

Units that can be booked individually

The product object

Attributes

iduuid

Unique identifier

ac_idtext | null

Identifier for products imported from AvailabilityCalendar.com

organization_iduuid

Identifier of the organization this product is defined in

parent_iduuid | null
products.id

Identifier of the parent unit

created_attimestamp with time zone

Creation timestamp

updated_attimestamp with time zone

Last modification timestamp

deleted_attimestamp with time zone | null

Timestamp at which the unit was deleted

approximate_addresstext

Approximate address of the unit

approximate_coordinatesjsonb | null

Coordinates of the approximate address

cancel_after_initial_payment_errorboolean
confirm_after_initial_paymentboolean

Whether to automatically confirm the booking after the initial payment. Only applies when interaction is request

confirmation_messagejsonb

Message to show to the customer after submitting a booking from a widget or website

cooldown_timeinteger

Minimum number of days between bookings. Only applies when rent_pricing_definition is services

ctajsonb

Call to action shown at the bottom of the booking form

currencytext

Currency bookings are made in

descriptionjsonb

Localized description

exact_addresstext

Exact address of the unit

exact_coordinatesjsonb | null

Coordinates of the exact address

ftstsvector

Full text search index

hide_exact_addressboolean

Whether to hide the exact address from customers before bookings are confirmed

ical_export_secrettext

Secret used to generate iCal feed URLs

ical_export_secret_no_detailstext

Secret used to generate iCal feed URLs without booking details

imagesjson

List of images

interactiontext

Interaction type, either request or book

latest_arrival_timetime without time zone | null
namejsonb

Localized name

payment_expiration_durationinteger
price_breakdown_specificitytext
rent_period"daily" | "nightly"

Rent period of the unit

rent_pricing_definitiontext

Pricing definition of the unit. Either configuration or services

request_status"CANCELLED" | "TENTATIVE" | "CONFIRMED"

Status of new bookings. Only applies when interaction is request

timezonetext

Timezone of the unit

The product object
{
"id": "00000000-0000-0000-0000-000000000000",
"ac_id": "",
"organization_id": "00000000-0000-0000-0000-000000000000",
"parent_id": "00000000-0000-0000-0000-000000000000",
"created_at": "2024-10-18T05:34:25.351Z",
"updated_at": "2024-10-18T05:34:25.351Z",
"deleted_at": "2024-10-18T05:34:25.351Z",
"approximate_address": "",
"approximate_coordinates": {},
"cancel_after_initial_payment_error": false,
"confirm_after_initial_payment": false,
"confirmation_message": {},
"cooldown_time": 0,
"cta": {},
"currency": "",
"description": {},
"exact_address": "",
"exact_coordinates": {},
"hide_exact_address": false,
"ical_export_secret": "",
"ical_export_secret_no_details": "",
"images": null,
"interaction": "request",
"latest_arrival_time": null,
"name": {},
"payment_expiration_duration": 0,
"price_breakdown_specificity": "combined",
"rent_period": "nightly",
"rent_pricing_definition": "configurations",
"request_status": "TENTATIVE",
"timezone": "UTC"
}

List products

Filters

idFilter<>

Unique identifier

ac_idFilter<>

Identifier for products imported from AvailabilityCalendar.com

organization_idFilter<>

Identifier of the organization this product is defined in

parent_idFilter<>

Identifier of the parent unit

created_atFilter<>

Creation timestamp

updated_atFilter<>

Last modification timestamp

deleted_atFilter<>

Timestamp at which the unit was deleted

approximate_addressFilter<>

Approximate address of the unit

approximate_coordinatesFilter<>

Coordinates of the approximate address

cancel_after_initial_payment_errorFilter<>
confirm_after_initial_paymentFilter<>

Whether to automatically confirm the booking after the initial payment. Only applies when interaction is request

confirmation_messageFilter<>

Message to show to the customer after submitting a booking from a widget or website

cooldown_timeFilter<>

Minimum number of days between bookings. Only applies when rent_pricing_definition is services

ctaFilter<>

Call to action shown at the bottom of the booking form

currencyFilter<>

Currency bookings are made in

descriptionFilter<>

Localized description

exact_addressFilter<>

Exact address of the unit

exact_coordinatesFilter<>

Coordinates of the exact address

ftsFilter<>

Full text search index

hide_exact_addressFilter<>

Whether to hide the exact address from customers before bookings are confirmed

ical_export_secretFilter<>

Secret used to generate iCal feed URLs

ical_export_secret_no_detailsFilter<>

Secret used to generate iCal feed URLs without booking details

imagesFilter<>

List of images

interactionFilter<>

Interaction type, either request or book

latest_arrival_timeFilter<>
nameFilter<>

Localized name

payment_expiration_durationFilter<>
price_breakdown_specificityFilter<>
rent_periodFilter<>

Rent period of the unit

rent_pricing_definitionFilter<>

Pricing definition of the unit. Either configuration or services

request_statusFilter<>

Status of new bookings. Only applies when interaction is request

timezoneFilter<>

Timezone of the unit

Responses

200

A list of products with the selected columns

206

Partial Content

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

Update products

Filters

idFilter<>

Unique identifier

ac_idFilter<>

Identifier for products imported from AvailabilityCalendar.com

organization_idFilter<>

Identifier of the organization this product is defined in

parent_idFilter<>

Identifier of the parent unit

created_atFilter<>

Creation timestamp

updated_atFilter<>

Last modification timestamp

deleted_atFilter<>

Timestamp at which the unit was deleted

approximate_addressFilter<>

Approximate address of the unit

approximate_coordinatesFilter<>

Coordinates of the approximate address

cancel_after_initial_payment_errorFilter<>
confirm_after_initial_paymentFilter<>

Whether to automatically confirm the booking after the initial payment. Only applies when interaction is request

confirmation_messageFilter<>

Message to show to the customer after submitting a booking from a widget or website

cooldown_timeFilter<>

Minimum number of days between bookings. Only applies when rent_pricing_definition is services

ctaFilter<>

Call to action shown at the bottom of the booking form

currencyFilter<>

Currency bookings are made in

descriptionFilter<>

Localized description

exact_addressFilter<>

Exact address of the unit

exact_coordinatesFilter<>

Coordinates of the exact address

ftsFilter<>

Full text search index

hide_exact_addressFilter<>

Whether to hide the exact address from customers before bookings are confirmed

ical_export_secretFilter<>

Secret used to generate iCal feed URLs

ical_export_secret_no_detailsFilter<>

Secret used to generate iCal feed URLs without booking details

imagesFilter<>

List of images

interactionFilter<>

Interaction type, either request or book

latest_arrival_timeFilter<>
nameFilter<>

Localized name

payment_expiration_durationFilter<>
price_breakdown_specificityFilter<>
rent_periodFilter<>

Rent period of the unit

rent_pricing_definitionFilter<>

Pricing definition of the unit. Either configuration or services

request_statusFilter<>

Status of new bookings. Only applies when interaction is request

timezoneFilter<>

Timezone of the unit

Body

Partial<Product>

Responses

204

The updated products with the selected columns

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