List the resources the Application may sell

Lists the rooms and other resources the Application may sell, one page at a time. A resource is listed when the operator opened it for external booking in a context the Application’s role reaches. Filter by operationalContextId to show one site. Each resource carries its booking rules, its price and the room layouts a request may name.

GET/v1/booking/resources

Authorization

AuthorizationOAuth2 access token · headerrequired

An access token for an Application, from the client_credentials grant. An installed connector gets its token from the installation-token grant instead. Send it as Authorization: Bearer <token>.

Query parameters

operationalContextIdstring<uuid>

Only return resources in this operational context.

cursorstring

The nextCursor of the previous page. Leave it out for the first page.

min length 1

limitinteger

The most resources to return, up to 100. Defaults to 50.

min 1 · max 100 · default: 50

Responses

200

One page of resources.

itemsExternallyBookableResource[]required

The resources on this page.

Show properties

Array of ExternallyBookableResource

idstring<uuid>required

The resource id.

namestringrequired

The name the operator gave the resource.

resourceTypestringrequired

What kind of thing the resource is.

Allowed:roomdeskparkingphone_boothday_passequipmentother

descriptionstringrequired

The operator's description of the resource. An empty string when there is none.

capacityintegerrequired

How many people the resource holds, as the operator states it. Shown to guests, not enforced.

min -9007199254740991 · max 9007199254740991

operationalContextIdstring<uuid>required

The operational context the resource belongs to, usually one site of the operator.

timeZonestringrequired

The IANA time zone of the resource's local dates and hours, for example Europe/Stockholm.

roomNamestring

The name of the room the resource is in. Absent when it is not in a room.

concurrentBookingLimitintegerrequired

How many bookings may hold the same time. 1 means one at a time. Above 1 the resource is a pool, such as parking spots.

min 1 · max 9007199254740991

bookingRulesobjectrequired

How the resource is booked and the rules a booking must follow. model also decides the shape of the time spec a request sends.

Show properties

One of:

object

modelstringrequired

Booked by a start and an end time.

Allowed:time_interval

openingHoursobjectrequired

The hours a booking must fall inside, in the resource's time zone. source says where they come from.

Show properties

One of:

object

sourcestringrequired

The same hours every day.

Allowed:daily

openHourintegerrequired

The whole hour the resource opens, from 0 to 24, in its time zone.

min 0 · max 24

closeHourintegerrequired

The whole hour the resource closes, from 0 to 24, in its time zone. 24 is midnight at the end of the day.

min 0 · max 24

object

sourcestringrequired

Follows one of the opening-hours schedules the operator set for the site.

Allowed:context

scheduleIdstring<uuid>required

The id of the schedule followed.

object

sourcestringrequired

The resource has weekly hours of its own.

Allowed:weekly

hoursobjectrequired

Open windows for each day of the week, in the place's local time.

Show properties

mondayobject[]required

One weekday's open windows, which never overlap. An empty list means closed all day.

Show properties

Array of object

startMinuteOfDayintegerrequired

When the window opens, in minutes after local midnight: 480 is 08:00.

min 0 · max 1439

endMinuteOfDayintegerrequired

When the window closes, in minutes after local midnight. 1440 is the end of the day.

min 1 · max 1440

tuesdayobject[]required

One weekday's open windows, which never overlap. An empty list means closed all day.

Show properties

Array of object

startMinuteOfDayintegerrequired

When the window opens, in minutes after local midnight: 480 is 08:00.

min 0 · max 1439

endMinuteOfDayintegerrequired

When the window closes, in minutes after local midnight. 1440 is the end of the day.

min 1 · max 1440

wednesdayobject[]required

One weekday's open windows, which never overlap. An empty list means closed all day.

Show properties

Array of object

startMinuteOfDayintegerrequired

When the window opens, in minutes after local midnight: 480 is 08:00.

min 0 · max 1439

endMinuteOfDayintegerrequired

When the window closes, in minutes after local midnight. 1440 is the end of the day.

min 1 · max 1440

thursdayobject[]required

One weekday's open windows, which never overlap. An empty list means closed all day.

Show properties

Array of object

startMinuteOfDayintegerrequired

When the window opens, in minutes after local midnight: 480 is 08:00.

min 0 · max 1439

endMinuteOfDayintegerrequired

When the window closes, in minutes after local midnight. 1440 is the end of the day.

min 1 · max 1440

fridayobject[]required

One weekday's open windows, which never overlap. An empty list means closed all day.

Show properties

Array of object

startMinuteOfDayintegerrequired

When the window opens, in minutes after local midnight: 480 is 08:00.

min 0 · max 1439

endMinuteOfDayintegerrequired

When the window closes, in minutes after local midnight. 1440 is the end of the day.

min 1 · max 1440

saturdayobject[]required

One weekday's open windows, which never overlap. An empty list means closed all day.

Show properties

Array of object

startMinuteOfDayintegerrequired

When the window opens, in minutes after local midnight: 480 is 08:00.

min 0 · max 1439

endMinuteOfDayintegerrequired

When the window closes, in minutes after local midnight. 1440 is the end of the day.

min 1 · max 1440

sundayobject[]required

One weekday's open windows, which never overlap. An empty list means closed all day.

Show properties

Array of object

startMinuteOfDayintegerrequired

When the window opens, in minutes after local midnight: 480 is 08:00.

min 0 · max 1439

endMinuteOfDayintegerrequired

When the window closes, in minutes after local midnight. 1440 is the end of the day.

min 1 · max 1440

bufferMinutesintegerrequired

Minutes kept free before and after every booking.

min 0 · max 1440

durationIncrementMinutesintegerrequired

The step, in minutes, that a booking's local start and its length must land on. A multiple of 5.

max 1440

minimumDurationMinutesinteger

The shortest booking, in minutes. Absent means one increment.

max 525600

maximumDurationMinutesinteger

The longest booking, in minutes. Absent means no maximum.

max 525600

maximumBookingsPerWeekinteger

The most bookings one person may hold on the resource per week. Absent means no limit.

max 1000

minimumBookingNoticeMinutesinteger

How many minutes before its start a booking must be made at the latest. Absent means no notice is needed.

min 0 · max 525600

minimumCancellationNoticeMinutesinteger

How many minutes before its start a booking can still be cancelled at the latest. Absent means no limit.

min 0 · max 525600

approvalExpiryMinutesinteger

How many minutes a request waiting for approval stays open before it expires. Absent means it waits until an operator decides.

max 525600

object

modelstringrequired

Booked as a stay between two local dates.

Allowed:date_interval

startMinuteOfDayintegerrequired

The arrival time on the first date, in minutes after local midnight.

min 0 · max 1439

endMinuteOfDayintegerrequired

The departure time on the last date, in minutes after local midnight. 1440 is midnight at the end of the day.

min 0 · max 1440

minimumDaysinteger

The fewest nights a stay may last. Absent means one.

max 365

maximumDaysinteger

The most nights a stay may last. Absent means no maximum.

max 365

maximumBookingsPerWeekinteger

The most bookings one person may hold on the resource per week. Absent means no limit.

max 1000

minimumBookingNoticeMinutesinteger

How many minutes before its start a booking must be made at the latest. Absent means no notice is needed.

min 0 · max 525600

minimumCancellationNoticeMinutesinteger

How many minutes before its start a booking can still be cancelled at the latest. Absent means no limit.

min 0 · max 525600

approvalExpiryMinutesinteger

How many minutes a request waiting for approval stays open before it expires. Absent means it waits until an operator decides.

max 525600

object

modelstringrequired

Booked one slot at a time from a weekly schedule.

Allowed:time_slots

scheduleobjectrequired

Open windows for each day of the week, in the place's local time.

Show properties

mondayobject[]required

One weekday's open windows, which never overlap. An empty list means closed all day.

Show properties

Array of object

startMinuteOfDayintegerrequired

When the window opens, in minutes after local midnight: 480 is 08:00.

min 0 · max 1439

endMinuteOfDayintegerrequired

When the window closes, in minutes after local midnight. 1440 is the end of the day.

min 1 · max 1440

tuesdayobject[]required

One weekday's open windows, which never overlap. An empty list means closed all day.

Show properties

Array of object

startMinuteOfDayintegerrequired

When the window opens, in minutes after local midnight: 480 is 08:00.

min 0 · max 1439

endMinuteOfDayintegerrequired

When the window closes, in minutes after local midnight. 1440 is the end of the day.

min 1 · max 1440

wednesdayobject[]required

One weekday's open windows, which never overlap. An empty list means closed all day.

Show properties

Array of object

startMinuteOfDayintegerrequired

When the window opens, in minutes after local midnight: 480 is 08:00.

min 0 · max 1439

endMinuteOfDayintegerrequired

When the window closes, in minutes after local midnight. 1440 is the end of the day.

min 1 · max 1440

thursdayobject[]required

One weekday's open windows, which never overlap. An empty list means closed all day.

Show properties

Array of object

startMinuteOfDayintegerrequired

When the window opens, in minutes after local midnight: 480 is 08:00.

min 0 · max 1439

endMinuteOfDayintegerrequired

When the window closes, in minutes after local midnight. 1440 is the end of the day.

min 1 · max 1440

fridayobject[]required

One weekday's open windows, which never overlap. An empty list means closed all day.

Show properties

Array of object

startMinuteOfDayintegerrequired

When the window opens, in minutes after local midnight: 480 is 08:00.

min 0 · max 1439

endMinuteOfDayintegerrequired

When the window closes, in minutes after local midnight. 1440 is the end of the day.

min 1 · max 1440

saturdayobject[]required

One weekday's open windows, which never overlap. An empty list means closed all day.

Show properties

Array of object

startMinuteOfDayintegerrequired

When the window opens, in minutes after local midnight: 480 is 08:00.

min 0 · max 1439

endMinuteOfDayintegerrequired

When the window closes, in minutes after local midnight. 1440 is the end of the day.

min 1 · max 1440

sundayobject[]required

One weekday's open windows, which never overlap. An empty list means closed all day.

Show properties

Array of object

startMinuteOfDayintegerrequired

When the window opens, in minutes after local midnight: 480 is 08:00.

min 0 · max 1439

endMinuteOfDayintegerrequired

When the window closes, in minutes after local midnight. 1440 is the end of the day.

min 1 · max 1440

openingHoursobject

Opening hours that follow one of the opening-hours schedules the operator set for the site.

Show properties

sourcestringrequired

Follows one of the opening-hours schedules the operator set for the site.

Allowed:context

scheduleIdstring<uuid>required

The id of the schedule followed.

maximumBookingsPerWeekinteger

The most bookings one person may hold on the resource per week. Absent means no limit.

max 1000

minimumBookingNoticeMinutesinteger

How many minutes before its start a booking must be made at the latest. Absent means no notice is needed.

min 0 · max 525600

minimumCancellationNoticeMinutesinteger

How many minutes before its start a booking can still be cancelled at the latest. Absent means no limit.

min 0 · max 525600

approvalExpiryMinutesinteger

How many minutes a request waiting for approval stays open before it expires. Absent means it waits until an operator decides.

max 525600

object

modelstringrequired

Booked by picking the date a fixed window starts on.

Allowed:date_span

startMinuteOfDayintegerrequired

When the window starts on the picked date, in minutes after local midnight.

min 0 · max 1439

endMinuteOfDayintegerrequired

When the window ends on its last day, in minutes after local midnight. 1440 is midnight at the end of the day.

min 0 · max 1440

endDayOffsetintegerrequired

How many days after the picked date the window ends. 0 means the same day.

min 0 · max 90

maximumBookingsPerWeekinteger

The most bookings one person may hold on the resource per week. Absent means no limit.

max 1000

minimumBookingNoticeMinutesinteger

How many minutes before its start a booking must be made at the latest. Absent means no notice is needed.

min 0 · max 525600

minimumCancellationNoticeMinutesinteger

How many minutes before its start a booking can still be cancelled at the latest. Absent means no limit.

min 0 · max 525600

approvalExpiryMinutesinteger

How many minutes a request waiting for approval stays open before it expires. Absent means it waits until an operator decides.

max 525600

openingHoursInEffectobject

Open windows for each day of the week, in the place's local time.

Show properties

mondayobject[]required

One weekday's open windows, which never overlap. An empty list means closed all day.

Show properties

Array of object

startMinuteOfDayintegerrequired

When the window opens, in minutes after local midnight: 480 is 08:00.

min 0 · max 1439

endMinuteOfDayintegerrequired

When the window closes, in minutes after local midnight. 1440 is the end of the day.

min 1 · max 1440

tuesdayobject[]required

One weekday's open windows, which never overlap. An empty list means closed all day.

Show properties

Array of object

startMinuteOfDayintegerrequired

When the window opens, in minutes after local midnight: 480 is 08:00.

min 0 · max 1439

endMinuteOfDayintegerrequired

When the window closes, in minutes after local midnight. 1440 is the end of the day.

min 1 · max 1440

wednesdayobject[]required

One weekday's open windows, which never overlap. An empty list means closed all day.

Show properties

Array of object

startMinuteOfDayintegerrequired

When the window opens, in minutes after local midnight: 480 is 08:00.

min 0 · max 1439

endMinuteOfDayintegerrequired

When the window closes, in minutes after local midnight. 1440 is the end of the day.

min 1 · max 1440

thursdayobject[]required

One weekday's open windows, which never overlap. An empty list means closed all day.

Show properties

Array of object

startMinuteOfDayintegerrequired

When the window opens, in minutes after local midnight: 480 is 08:00.

min 0 · max 1439

endMinuteOfDayintegerrequired

When the window closes, in minutes after local midnight. 1440 is the end of the day.

min 1 · max 1440

fridayobject[]required

One weekday's open windows, which never overlap. An empty list means closed all day.

Show properties

Array of object

startMinuteOfDayintegerrequired

When the window opens, in minutes after local midnight: 480 is 08:00.

min 0 · max 1439

endMinuteOfDayintegerrequired

When the window closes, in minutes after local midnight. 1440 is the end of the day.

min 1 · max 1440

saturdayobject[]required

One weekday's open windows, which never overlap. An empty list means closed all day.

Show properties

Array of object

startMinuteOfDayintegerrequired

When the window opens, in minutes after local midnight: 480 is 08:00.

min 0 · max 1439

endMinuteOfDayintegerrequired

When the window closes, in minutes after local midnight. 1440 is the end of the day.

min 1 · max 1440

sundayobject[]required

One weekday's open windows, which never overlap. An empty list means closed all day.

Show properties

Array of object

startMinuteOfDayintegerrequired

When the window opens, in minutes after local midnight: 480 is 08:00.

min 0 · max 1439

endMinuteOfDayintegerrequired

When the window closes, in minutes after local midnight. 1440 is the end of the day.

min 1 · max 1440

defaultPriceobjectrequired

An amount of money in one currency, never negative.

Show properties

minorUnitsintegerrequired

The amount in minor units of the currency, such as öre for SEK. 0 means free.

min 0 · max 9007199254740991

currencystringrequired

An ISO 4217 currency code, for example SEK.

Allowed:SEKNOKDKKEURUSDGBP

vatRateBasisPointsintegerrequired

The VAT rate in basis points. 2500 is 25%.

min 0 · max 9007199254740991

vatTreatmentstring

Why a line is taxed at 0%: exempt when the supply is exempt from VAT, reverseCharge when the buyer accounts for the VAT.

Allowed:exemptreverseCharge

pricingUnitstringrequired

How the price is counted. hour is charged per hour, pro rata. session is one flat price per booking. night is charged per night of a stay.

Allowed:hoursessionnight

roomLayoutsstring[]required

The furniture layouts a room offers, in the order to show them. Each appears once.

max items 3

imageUrlsstring<uri>[]required

Public URLs of the resource's images, in display order.

purchaseTermsUrlstring<uri>

A public URL of the terms the guest accepts by booking. Absent when the operator set none.

nextCursorstring

Pass it as cursor to read the next page. Absent on the last page.

400

The request is not valid, or a business rule refused it. code names the rule.

typestringrequired

Always about:blank.

titlestringrequired

The HTTP status phrase, for example Not Found.

statusintegerrequired

The HTTP status code.

min -9007199254740991 · max 9007199254740991

detailstring

What went wrong, for a person to read. Do not parse it.

codestring

Names the rule that refused the request. Match on this, not on detail.

Allowed:TWIN_NODE_NOT_FOUNDTWIN_OPERATIONAL_CONTEXT_NOT_DELETABLETWIN_NODE_SUBTREE_IN_USETWIN_OPENING_HOURS_SCHEDULE_LIMIT_REACHEDTWIN_OPENING_HOURS_SCHEDULE_NAME_ALREADY_EXISTSTWIN_OPENING_HOURS_SCHEDULE_NOT_FOUNDOPERATIONS_ISSUE_TRANSITION_INVALIDOPERATIONS_ISSUE_CLOSE_REASON_REQUIREDOPERATIONS_ISSUE_CONCURRENT_MODIFICATIONOPERATIONS_ISSUE_KEY_ALREADY_USEDOPERATIONS_PRIORITY_ARCHIVEDOPERATIONS_PRIORITY_KEY_ALREADY_EXISTSOPERATIONS_ISSUE_STATUS_ARCHIVEDOPERATIONS_ISSUE_STATUS_CATEGORY_WOULD_BE_EMPTYOPERATIONS_ISSUE_STATUS_REORDER_INCOMPLETEOPERATIONS_VOCABULARY_OWNER_INVALIDOPERATIONS_ISSUE_RULE_KIND_CONFLICTOPERATIONS_ISSUE_RULE_STATUS_NOT_IN_SETOPERATIONS_COMMENT_NOT_AUTHOROPERATIONS_COMMENT_NEEDS_CONTENTOPERATIONS_ATTACHMENT_REJECTEDOPERATIONS_ATTACHMENT_NOT_UPLOADEROPERATIONS_WORK_ORDER_DELEGATION_ACTIVEOPERATIONS_WORK_ORDER_NOT_DELETABLEOPERATIONS_WORK_ORDER_DEPENDENCY_CYCLEOPERATIONS_DELEGATION_STATUS_INVALIDOPERATIONS_DELEGATION_NOT_ENGAGED_PARTYOPERATIONS_DELEGATION_ROLE_CANNOT_ACTOPERATIONS_DISCIPLINE_LABEL_ALREADY_EXISTSOPERATIONS_DISCIPLINE_UNKNOWNOPERATIONS_DISCIPLINE_ARCHIVEDOPERATIONS_SUPPLIER_ROSTER_EMAIL_EXISTSTENANT_BILLING_ACCOUNT_PRIVATE_AGENT_HAS_ONETENANT_BILLING_ACCOUNT_DEFAULT_NOT_REMOVABLETENANT_BILLING_ACCOUNT_INCOMPLETETENANT_CONTRACT_BILLING_ACCOUNT_REQUIREDTENANT_UNIT_ALREADY_LEASEDTENANT_CONTRACT_TERMINATION_RETROACTIVETENANT_CONTRACT_TERMINATION_NOT_EARLIERTENANT_CONTRACT_TERMINATION_LOCKEDTENANT_CONTRACT_BILLING_TERMS_LOCKEDTENANT_CONTRACT_OWNER_NOT_BUSINESSTENANT_CONTRACT_LINE_OUTSIDE_OWNER_CONETENANT_CONTRACT_LINE_IN_USETENANT_CONTRACT_LINE_TERMINATEDTENANT_CONTRACT_LINE_NOT_SEATABLETENANT_CONTRACT_LINE_NO_ENABLEMENTTENANT_CONTRACT_LINE_SEAT_LIMIT_REACHEDTENANT_CONTRACT_LINE_AT_MINIMUM_SEATSTENANT_CONTRACT_SEAT_EMPTYTENANT_LEASABLE_UNIT_ALREADY_EXISTSTENANT_LEASABLE_UNIT_CONTEXT_INVALIDTENANT_PRODUCT_SKU_ALREADY_EXISTSTENANT_PRODUCT_RETIREDTENANT_PRODUCT_CONTEXT_INVALIDTENANT_PRODUCT_GRANT_DUPLICATETENANT_PRODUCT_GRANT_ENABLEMENT_MISMATCHTENANT_PRODUCT_GRANT_IS_HOMETENANT_PRODUCT_GRANT_SHADOWEDTENANT_PRODUCT_CATEGORY_NAME_ALREADY_EXISTSTENANT_PRODUCT_CATEGORY_RETIREDTENANT_PRODUCT_CATEGORY_VALUE_LOCKEDTENANT_AGENT_NOT_READYTENANT_USER_ALREADY_ON_ROSTERTENANT_AGENT_IDENTIFIER_ALREADY_USEDTENANT_AGENT_TYPE_MISMATCHTENANT_CUSTOMER_NUMBER_TAKENTENANT_CUSTOMER_NUMBER_INVALIDTENANT_SCHEME_DEFAULT_TIER_REQUIREDTENANT_SCHEME_TIER_ROLE_INVALIDTENANT_SCHEME_CONTEXT_TYPE_MISMATCHTENANT_SCHEME_NOT_ENABLED_HERETENANT_SCHEME_DEFAULT_TIER_NOT_PLACEABLETENANT_COMPANY_REGISTRY_NOT_SUPPORTEDTENANT_COMPANY_REGISTRY_UNAVAILABLEBILLING_INTEGRATION_NOT_CONFIGUREDBILLING_INTEGRATION_GATE_NOT_DECLAREDBILLING_EXTERNAL_REFERENCE_ALREADY_USEDBILLING_INVOICE_STATUS_INVALIDBILLING_PAYMENT_REPLAY_MISMATCHBILLING_PAYMENT_REVERSEDBILLING_PAYMENT_NOT_FOUNDBILLING_PAYMENT_AMOUNT_INVALIDBILLING_WRITE_OFF_REPLAY_MISMATCHBILLING_WRITE_OFF_AMOUNT_INVALIDBILLING_PROPOSAL_STATUS_INVALIDBILLING_PROPOSAL_MATERIAL_ALREADY_INVOICEDBILLING_CREDIT_NOTE_INVOICE_NOT_CREDITABLEBILLING_CREDIT_NOTE_NO_PENDING_CORRECTIONSBILLING_INVOICE_RUN_NOT_CONTINUABLEBILLING_CREDIT_EXCEEDS_LINEBILLING_CREDIT_EXCEEDS_INVOICEBILLING_CREDIT_WITHHELDBILLING_CREDIT_ACT_REPLAY_MISMATCHBILLING_MANUAL_CREDIT_VAT_RATE_UNKNOWNBILLING_CORRECTION_NOT_WITHDRAWABLECOMMUNITY_POST_COVER_REJECTEDCOMMUNITY_POST_ATTACHMENT_REJECTEDCOMMUNITY_POST_COVER_LIMIT_REACHEDCOMMUNITY_POST_ATTACHMENT_LIMIT_REACHEDCOMMUNITY_PROMOTION_IMAGE_LIMIT_REACHEDCOMMUNITY_VOUCHER_CODE_TAKENCOMMUNITY_PUBLISH_AT_NOT_FUTURECOMMUNITY_PINNED_UNTIL_NOT_FUTURECOMMUNITY_POST_NOT_SCHEDULEDCOMMUNITY_POST_NOT_PUBLISHEDCOMMUNITY_POST_NOT_UNPUBLISHEDCOMMUNITY_DRAFT_INCOMPLETECOMMUNITY_PROMOTION_INCOMPLETECOMMUNITY_PROMOTION_NOT_DRAFTCOMMUNITY_PROMOTION_NOT_SCHEDULEDCOMMUNITY_PROMOTION_NOT_ACTIVECOMMUNITY_PROMOTION_NOT_INACTIVECOMMUNICATIONS_ATTACHMENT_PENDING_LIMIT_EXCEEDEDCOMMUNICATIONS_ATTACHMENT_REJECTEDCOMMUNICATIONS_ATTACHMENT_NOT_CLAIMABLECOMMUNICATIONS_BROADCAST_SCHEDULED_AT_NOT_FUTURECOMMUNICATIONS_BROADCAST_NOT_SCHEDULEDCOMMUNITY_EVENT_FULLCOMMUNITY_EVENT_ATTENDEE_EXISTSCOMMUNITY_EVENT_CAPACITY_BELOW_ATTENDEESCOMMUNITY_POLL_CLOSEDCOMMUNITY_POLL_ALREADY_ANSWEREDBOOKING_SLOT_TAKENBOOKING_NO_COVERING_CONTRACTBOOKING_CONTRACT_ATTRIBUTION_AMBIGUOUSBOOKING_CONTRACT_NOT_A_CANDIDATEBOOKING_NO_SHARED_CONTRACTBOOKING_EXTERNAL_CONTRACT_NOT_BILLABLEBOOKING_EXTERNAL_CUSTOMER_NOT_FOUNDBOOKING_EXTERNAL_CUSTOMER_BILLING_ACCOUNT_REQUIREDBOOKING_EXTERNAL_BILLING_ACCOUNT_INCOMPLETEBOOKING_EXTERNAL_INVOICING_DETAILS_REQUIREDBOOKING_EXTERNAL_REQUIRES_APPROVALBOOKING_REQUEST_ID_ALREADY_USEDBOOKING_GUEST_LINK_INVALIDBOOKING_GUEST_LINK_NOT_RESENDABLEBOOKING_NOT_EXTERNALBOOKING_PRICE_RULE_AMBIGUOUSBOOKING_PRICE_RULE_NOT_APPLICABLEBOOKING_NOT_PENDING_APPROVALBOOKING_APPROVAL_WINDOW_PASSEDBOOKING_RESOURCE_IMAGE_REJECTEDBOOKING_RESOURCE_PURCHASE_TERMS_REJECTEDBOOKING_OUTSIDE_OPEN_HOURSBOOKING_DURATION_TOO_SHORTBOOKING_DURATION_TOO_LONGBOOKING_DURATION_NOT_ON_INCREMENTBOOKING_START_NOT_ON_INCREMENTBOOKING_WEEKLY_QUOTA_EXCEEDEDBOOKING_BUFFER_CONFLICTBOOKING_NOTICE_TOO_SHORTBOOKING_CANCELLATION_NOTICE_EXPIREDBOOKING_ALREADY_DELIVEREDBOOKING_NOT_CHARGEDBOOKING_ALREADY_STARTEDBOOKING_ACCESS_ALREADY_OPENBOOKING_NOT_RESCHEDULABLEBOOKING_TIME_SPEC_MODEL_MISMATCHBOOKING_SLOT_NOT_IN_SCHEDULEBOOKING_DATE_INTERVAL_EMPTYBOOKING_DATE_SPAN_EMPTYBOOKING_DATE_SPAN_REQUIRES_SESSION_PRICINGBOOKING_DATE_INTERVAL_REQUIRES_NIGHT_PRICINGBOOKING_NIGHT_PRICING_REQUIRES_DATE_INTERVALBOOKING_RESOURCE_BUFFER_NOT_ON_INCREMENTBOOKING_STAY_TOO_SHORTBOOKING_STAY_TOO_LONGBOOKING_UPLOAD_PENDING_LIMIT_EXCEEDEDBOOKING_IN_THE_PASTBOOKING_HORIZON_EXCEEDEDBOOKING_DURATION_CEILING_EXCEEDEDBOOKING_PARTICIPANTS_NOT_SUPPORTEDBOOKING_PARTICIPANT_NOT_SEATEDBOOKING_RESOURCE_PARTICIPANTS_GROUP_CONFLICTBOOKING_RESOURCE_CURRENCY_MISMATCHBOOKING_OPENING_HOURS_SCHEDULE_NOT_FOUNDBOOKING_RESOURCE_GROUP_OUTSIDE_CONTEXTBOOKING_ADD_ON_PRODUCT_IMAGE_REJECTEDBOOKING_ADD_ON_PRODUCT_RETIREDBOOKING_ADD_ON_PRODUCT_RESOURCE_OUTSIDE_CONTEXTBOOKING_ADD_ON_NOT_OFFEREDBOOKING_ADD_ON_DELIVERY_OUTSIDE_BOOKINGBOOKING_ADD_ON_DELIVERY_OUTSIDE_AVAILABILITYBOOKING_ADD_ON_ORDER_LEAD_TOO_SHORTBOOKING_ADD_ON_CUTOFF_PASSEDBOOKING_ADD_ON_SPECIAL_PORTIONS_INVALIDBOOKING_ADD_ON_LINE_LIMIT_EXCEEDEDBOOKING_ADD_ON_ON_INTERNAL_BOOKINGBOOKING_ADD_ON_LINE_NOT_FOUNDBOOKING_ADD_ON_LINE_DELIVEREDBOOKING_ADD_ON_LINE_NO_LONGER_FITSBOOKING_ROOM_LAYOUT_NOT_OFFEREDBOOKING_ROOM_LAYOUT_CUTOFF_PASSEDBOOKING_ROOM_LAYOUT_NOT_CHANGEABLEBOOKING_ROOM_SETUP_NOT_FOUNDACCESS_ACCESSY_CREDENTIALS_REJECTEDACCESS_ACCESSY_API_CLIENT_ALREADY_REGISTEREDACCESS_ACCESSY_API_CLIENT_MISSINGACCESS_GROUP_UNKNOWNACCESS_ACCESSY_UNAVAILABLEACCESS_SUBSCRIPTION_ALREADY_REGISTEREDACCESS_PHONE_MISSINGACCESS_ENROLLMENT_NOT_BEGUNACCESS_ENROLLMENT_EXPIREDACCESS_ENROLLMENT_REFUSEDACCESS_RECOVERY_KEY_REQUIREDACCESS_RECOVERY_KEY_INVALIDACCESS_ENROLLMENT_REQUIREDORGANIZATION_NOT_ENTEREDAUTH_PHONE_VERIFICATION_REQUIREDAUTH_PHONE_VERIFICATION_INVALIDAUTH_PHONE_VERIFICATION_THROTTLEDACCESS_GROUP_ALREADY_CONFIGUREDACCESS_GROUP_NOT_READYACCESS_DOOR_ALREADY_LINKEDACCESS_ASSET_NOT_PUBLISHEDACCESS_ACCESSY_REQUEST_REFUSEDCRM_CONTRACT_TEMPLATE_RETIREDCRM_PACKAGE_RETIREDCRM_PRODUCT_RETIREDCRM_PRODUCT_UNKNOWNCRM_AGENT_UNKNOWNCRM_CUSTOMER_CHOICE_INVALIDCRM_PROSPECT_MATCHES_AGENTCRM_CUSTOMER_IS_AGENTCRM_AGREEMENT_BILLING_DETAILS_REQUIREDCRM_AGREEMENT_BILLING_ACCOUNT_EXISTSCRM_AGREEMENT_BILLING_DETAILS_TYPE_MISMATCHCRM_AGREEMENT_BILLING_DETAILS_INCOMPLETECRM_ROW_ACCESS_TERMS_INVALIDCRM_DEAL_LOSTCRM_DEAL_ACCEPTEDCRM_DEAL_TRANSITION_INVALIDCRM_DEAL_BUSINESS_CONTEXT_INVALIDCRM_PACKAGE_BUSINESS_CONTEXT_INVALIDCRM_PACKAGE_BUSINESS_CONTEXT_MISMATCHCRM_PACKAGE_PRODUCT_DUPLICATECRM_PRODUCT_OUTSIDE_BUSINESS_CONTEXTCRM_ROWS_EMPTYCRM_ROWS_LIMITCRM_ROW_QUANTITY_INVALIDCRM_CURRENCY_MISMATCHCRM_OFFER_TOKEN_INVALIDCRM_OFFER_EXPIREDCRM_OFFER_ALREADY_ANSWEREDCRM_OFFER_INVALIDATEDCRM_AGREEMENT_TRANSITION_INVALIDCRM_AGREEMENT_LOCKEDCRM_AGREEMENT_CANCELLEDCRM_AGREEMENT_START_DATE_MISSINGCRM_LEASABLE_UNIT_OCCUPIEDCRM_SIGNED_DOCUMENT_REJECTEDCRM_SIGNING_NOT_AVAILABLECRM_CONTRACT_BODY_MISSINGCRM_CONTRACT_VALUES_MISSINGCRM_CONTRACT_VARIABLE_UNKNOWNCRM_CONTRACT_PLACEHOLDERS_OPENCRM_CONTRACT_RENDER_FAILEDCRM_SIGNING_ATTEMPT_LIVECRM_SIGNING_ATTEMPT_ENDEDCRM_SIGNER_BUSINESS_CONTEXT_INVALIDCRM_SIGNER_NOT_ELIGIBLECRM_SIGNER_ALREADY_ADDEDCRM_SIGNER_UNAVAILABLECRM_SIGNING_PARTY_REPEATEDAPPLICATION_SECRET_LIMIT_REACHEDAPPLICATION_SECRET_NOT_FOUNDVALIDATION_FAILEDINTEGRATIONS_APP_INVALIDINTEGRATIONS_APP_ALREADY_EXISTSINTEGRATIONS_APP_INSTALLEDINTEGRATIONS_APP_ALREADY_INSTALLEDINTEGRATIONS_CONSENT_MISMATCHINTEGRATIONS_ROLE_NOT_GRANTABLEINTEGRATIONS_CONTEXT_LEVEL_MISMATCHINTEGRATIONS_CONFIGURATION_INVALIDINTEGRATIONS_POINT_ALREADY_FILLEDINTEGRATIONS_CONFIGURATION_NOT_FOUNDINTEGRATIONS_CONNECTION_NOT_SUPPORTEDINTEGRATIONS_CONNECTION_REFERENCE_INVALIDASSISTANT_CONVERSATION_NOT_FOUNDASSISTANT_CONFIRMATION_NOT_PENDINGASSISTANT_TURN_LIMIT_REACHEDASSISTANT_RATE_LIMITEDASSISTANT_MODEL_FAILEDASSISTANT_TURN_INTERRUPTED

issuesobject[]

With VALIDATION_FAILED: one entry per field that failed validation, each with its path and message.

401

The access token is missing, expired or not valid.

typestringrequired

Always about:blank.

titlestringrequired

The HTTP status phrase, for example Not Found.

statusintegerrequired

The HTTP status code.

min -9007199254740991 · max 9007199254740991

detailstring

What went wrong, for a person to read. Do not parse it.

codestring

Names the rule that refused the request. Match on this, not on detail.

issuesobject[]

With VALIDATION_FAILED: one entry per field that failed validation, each with its path and message.

403

The token does not allow this request.

typestringrequired

Always about:blank.

titlestringrequired

The HTTP status phrase, for example Not Found.

statusintegerrequired

The HTTP status code.

min -9007199254740991 · max 9007199254740991

detailstring

What went wrong, for a person to read. Do not parse it.

codestring

Names the rule that refused the request. Match on this, not on detail.

issuesobject[]

With VALIDATION_FAILED: one entry per field that failed validation, each with its path and message.

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

OAuth2 access tokenRemember on this deviceInclude my values in samples

Parameters

operationalContextIdqueryOnly return resources in this operational context.cursorqueryThe `nextCursor` of the previous page. Leave it out for the first page.limitqueryThe most resources to return, up to 100. Defaults to 50.

Request

curl -X GET 'https://api.hydda.one/v1/booking/resources' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'

const response = await fetch("https://api.hydda.one/v1/booking/resources", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN"
  }
});

import requests

response = requests.get(
    "https://api.hydda.one/v1/booking/resources",
    headers={
        "Authorization": "Bearer YOUR_ACCESS_TOKEN"
    },
)

Response

{
  "items": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "name": "string",
      "resourceType": "room",
      "description": "string",
      "capacity": -9007199254740991,
      "operationalContextId": "a3f64ce2-1602-4028-b89f-abb2bb8c71bc",
      "timeZone": "string",
      "roomName": "string",
      "concurrentBookingLimit": 1,
      "bookingRules": {
        "model": "time_interval",
        "openingHours": {
          "source": "daily",
          "openHour": 0,
          "closeHour": 0
        },
        "bufferMinutes": 0,
        "durationIncrementMinutes": 1,
        "minimumDurationMinutes": 1,
        "maximumDurationMinutes": 1,
        "maximumBookingsPerWeek": 1,
        "minimumBookingNoticeMinutes": 0,
        "minimumCancellationNoticeMinutes": 0,
        "approvalExpiryMinutes": 1
      },
      "openingHoursInEffect": {
        "monday": [
          {
            "startMinuteOfDay": 0,
            "endMinuteOfDay": 1
          }
        ],
        "tuesday": [
          {
            "startMinuteOfDay": 0,
            "endMinuteOfDay": 1
          }
        ],
        "wednesday": [
          {
            "startMinuteOfDay": 0,
            "endMinuteOfDay": 1
          }
        ],
        "thursday": [
          {
            "startMinuteOfDay": 0,
            "endMinuteOfDay": 1
          }
        ],
        "friday": [
          {
            "startMinuteOfDay": 0,
            "endMinuteOfDay": 1
          }
        ],
        "saturday": [
          {
            "startMinuteOfDay": 0,
            "endMinuteOfDay": 1
          }
        ],
        "sunday": [
          {
            "startMinuteOfDay": 0,
            "endMinuteOfDay": 1
          }
        ]
      },
      "defaultPrice": {
        "minorUnits": 0,
        "currency": "SEK"
      },
      "vatRateBasisPoints": 0,
      "vatTreatment": "exempt",
      "pricingUnit": "hour",
      "roomLayouts": [
        "conference"
      ],
      "imageUrls": [
        "http://example.com"
      ],
      "purchaseTermsUrl": "http://example.com"
    }
  ],
  "nextCursor": "string"
}

{
  "type": "string",
  "title": "string",
  "status": -9007199254740991,
  "detail": "string",
  "code": "TWIN_NODE_NOT_FOUND",
  "issues": [
    {
      "property1": null,
      "property2": null
    }
  ]
}

{
  "type": "string",
  "title": "string",
  "status": -9007199254740991,
  "detail": "string",
  "code": "TWIN_NODE_NOT_FOUND",
  "issues": [
    {
      "property1": null,
      "property2": null
    }
  ]
}

{
  "type": "string",
  "title": "string",
  "status": -9007199254740991,
  "detail": "string",
  "code": "TWIN_NODE_NOT_FOUND",
  "issues": [
    {
      "property1": null,
      "property2": null
    }
  ]
}