---
sourceDocument: Xanadu API Reference
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/xanadu/api-reference
Release :
- xanadu
ft:locale :
- en-US
ft:publication_title :
- Xanadu API Reference
ft:clusterId :
- crapiref
bundleId :
- crapiref
workflow :
- Creator
---
# WSD Reservable Module API
# WSD Reservable Module API {#ariaid-title1}
* Release version: Xanadu
*
* Updated August 1, 2024
*
*  16 minutes to read
The Workplace Service Delivery (WSD) Reservable Module API provides endpoints to retrieve details of a reservable module from a ServiceNow instance.
A reservable module groups similar types of workplace items. Employees can view these similar
items in a single category. For example, a room is a reservable module and it contains similar
workplace items such as meeting rooms, conference rooms, and other rooms.
To access this API, the caller must have the sn_wsd_core.workplace_user role and the Workplace
Reservation Management (sn_wsd_rsv) plugin must be activated. This API runs in the
`sn_wsd_rsv` namespace.
For additional information on Workplace Reservation Management, see [Workplace Reservation Management](https://www.servicenow.com/docs/access?context=workplace-rsv-mgmt-feat&version=xanadu&pubname=xanadu-employee-service-management&ft:locale=en-US).
## WSD Reservable Module - GET /sn_wsd_rsv/reservable_module/{sys_id} {#ariaid-title2}
Returns the details for a specified reservable module.
### URL format {#wsd_resv_mod-GET-reserv_mod__section_vt2_5vz_qtb}
Versioned URL: /api/sn_wsd_rsv/{api_version}/reservable_module/{sys_id}
Default URL: /api/sn_wsd_rsv/reservable_module/{sys_id}
### Supported request parameters
{#wsd_resv_mod-GET-reserv_mod__entry__2}{#wsd_resv_mod-GET-reserv_mod__version-not_optional-RESTAPI}
| Name | Description |
|-|-|
| api_version | Optional. Version of the endpoint to access. For example, v1 or v2. Only specify this value to use an endpoint version other than the latest. Data type: String |
| sys_id | Sys_id of the reversable module record to retrieve. Located in the Reservable Module \[sn_wsd_rsv_reservable_module\] table. Data type: String |
[Table 1. Path parameters]
{#wsd_resv_mod-GET-reserv_mod__entry__8}
| Name | Description |
|-|-|
| is_buildings_tree_data_required | Flag that indicates whether to return the building data associated with the reservable model. Valid values: * true: Return the building data. * false: Don't return the building data. Data type: Boolean Default: false |
| neighborhood | Only available if the Space Management (sn_wsd_spc_mgmt_neighborhood) plugin is activated. Sys_id of the neighborhood record to use in the encoded query. Located in the Neighborhood \[sn_wsd_spcmgmt_neighborhood\] table. For additional information on neighborhood space reservations, see [Create neighborhood reservations](https://www.servicenow.com/docs/access?context=create-neighborhood-reservations&version=xanadu&pubname=xanadu-employee-service-management&ft:locale=en-US). The endpoint checks if the neighborhood is valid and then retrieves the data required for the browse-by-neighborhood path. Data type: String |
[Table 2. Query parameters]
{#wsd_resv_mod-GET-reserv_mod__entry__14}
| Name | Description |
|-|-|
| None | |
[Table 3. Request body parameters (XML or JSON)]
### Headers {#wsd_resv_mod-GET-reserv_mod__section_k3d_swn_1yb}
The following request and response headers apply to this HTTP
action only, or apply to this action in a distinct way. For a list of general headers used
in the REST API, see [Supported REST API headers](https://servicenow-prod.fluidtopics.net/2vuQj3~2s_niNXyXhrbRZA "REST (REpresentational State Transfer) is a simple stateless architecture that provides standards between computer systems on the web, making it easier for them to communicate with each other.").
{#wsd_resv_mod-GET-reserv_mod__table_l3d_swn_1yb__entry__2}{#wsd_resv_mod-GET-reserv_mod__accept-RESTAPI}
| Header | Description |
|-|-|
| Accept | Data format of the response body. Supported types: application/json or application/xml. Default: application/json |
[Table 4. Request headers]
{#wsd_resv_mod-GET-reserv_mod__table_l3d_swn_1yb} {#wsd_resv_mod-GET-reserv_mod__table_m3d_swn_1yb__entry__2}
| Header | Description |
|-|-|
| None | |
[Table 5. Response headers]
{#wsd_resv_mod-GET-reserv_mod__table_m3d_swn_1yb}
### Status codes {#wsd_resv_mod-GET-reserv_mod__section_scs_twn_1yb}
The following status codes apply to this HTTP action. For a
list of possible status codes used in the REST API, see [REST API HTTP response
codes](https://servicenow-prod.fluidtopics.net/2vuQj3~2s_niNXyXhrbRZA "REST (REpresentational State Transfer) is a simple stateless architecture that provides standards between computer systems on the web, making it easier for them to communicate with each other.").
{#wsd_resv_mod-GET-reserv_mod__table_tcs_twn_1yb__entry__2}{#wsd_resv_mod-GET-reserv_mod__entry-200-status-code}{#wsd_resv_mod-GET-reserv_mod__entry-400-status-code}{#wsd_resv_mod-GET-reserv_mod__entry-401-status-code}{#wsd_resv_mod-GET-reserv_mod__entry-404-status-code}{#wsd_resv_mod-GET-reserv_mod__entry-500-status-code}
| Status code | Description |
|-|-|
| 200 | Successful. The request was successfully processed. |
| 400 | Bad Request. A bad request type or malformed request was detected. |
| 401 | Unauthorized. The user credentials are incorrect or have not been passed. |
| 404 | Not found. The requested item wasn't found. |
| 500 | Internal server error. An unexpected error occurred while processing the request. The response contains additional information about the error. |
[Table 6. Status codes]
{#wsd_resv_mod-GET-reserv_mod__table_tcs_twn_1yb}
### Response body parameters (JSON or XML)
{#wsd_resv_mod-GET-reserv_mod__id_w24_zwn_1yb__entry__2}{#wsd_resv_mod-GET-reserv_mod__allow_invitees-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__allow_whole_day-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__apply_to_shift-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__browse_by_area_enabled-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__browse_near_a_person_enabled-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__buildingTreeData-reserv_mod-row}{#wsd_resv_mod-GET-reserv_mod__buildingSysIds-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__checkin_before_minutes-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__display_number_of_attendees-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__display_on_behalf_of-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__display_sensitivity-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__display_value-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__enable_browse_by_area-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__enable_browse_near_a_person-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__enable_facet_filter-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__enable_group_reservations-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__enable_ical_generation-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__font_awesome_icon-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__inline_title-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__layout_mapping-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__layout_mapping_body-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__layout_mapping_body_field-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__layout_mapping_body_field_to_display-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__layout_mapping_body_icon-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__layout_mapping_body_label-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__layout_mapping_description-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__layout_mapping_image-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__layout_mapping_subtitle-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__layout_mapping_subtitle_asc-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__layout_mapping_title-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__max_days_in_future-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__max_occurrences-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__name-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__nbh_avail-reserv_mod-ph}{#wsd_resv_mod-GET-reserv_mod__override_approval_policy-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__require_cancel_notes-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__require_cc_dept_check-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__require_subject-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__reservable_columns-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__reservable_container_field-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__reservable_filter-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__reservable_quantity_field-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__reservable_table-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__reservable_type-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__reservable_views-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__reservable_views_iconClass-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__reservable_views_isDefault-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__reservable_views_label-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__reservable_views_order-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__reservable_views_type-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__reservation_paths-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__reservation_paths_displayValue-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__reservation_paths_value-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__search_limit-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__selection_type-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__short_description-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__show_map_view-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__sys_id-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__timeSlots-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__timeSlots_name-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__timeSlots_short_description-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__timeSlots_slot_end-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__timeSlots_slot_start-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__timeSlots_slot_sys_id-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__title-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__virtual_meeting_provider-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__virtual_meeting_provider_display_value-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__virtual_meeting_provider_sys_id-reserv_mod-entry}
| Name | Description |
|-|-|
| results | Details for the requested reservable module. Data type: Object { "result": { "allow_invitees": Boolean, "allow_whole_day": Boolean, "apply_to_shift": Boolean, "browse_by_area_enabled": Boolean, "browse_by_neighborhood_enabled": Boolean, "browse_near_a_person_enabled": Boolean, "buildingsTreeData": [Array], "buildingSysIds": [Array], "checkin_before_minutes": Number, "display_number_of_attendees": Boolean, "display_on_behalf_of": Boolean, "display_sensitivity": Boolean, "display_value": "String", "enable_browse_by_area": Boolean, "enable_browse_by_neighborhood": Boolean, "enable_browse_near_a_person": Boolean, "enable_facet_filter": Boolean, "enable_group_reservations": Boolean, "enable_ical_generation": Boolean, "font_awesome_icon": "String", "inline_title": "String", "layout_mapping": {JSON Object}, "max_days_in_future": Number, "max_occurrences": Number, "name": "String", "nbhBuildingIds": [Array], "nbhBuildingsData": [Array]; "nbhBuildingsTreeData": [Array], "override_approval_policy": "String", "require_cancel_notes": Boolean, "require_cc_dept_check": Boolean, "require_subject": Boolean, "reservable_columns": [Array], "reservable_container_field": "String", "reservable_filter": "String", "reservable_quantity_field": "String", "reservable_table": "String", "reservable_type": "String", "reservable_views": [Array], "reservation_paths": [Array], "search_limit": Number, "selection_type": "String", "short_description": "String", "show_map_view": Boolean, "sys_id": "String", "timeSlots": [Array], "title": "String", "virtual_meeting_provider": {Object} } } |
| result.allow_invitees | Flag that indicates whether employees are able to add invitees to the reservation. Valid values: * true: Allow employees to add invitees to the reservation. * false: Don't allow employees to add invitees to the reservation. Data type: Boolean |
| result.allow_whole_day | Flag that indicates whether users can reserve the reservable for the entire day. Valid values: * true: Allow users to reserve for the entire day. * false: Don't allow users to reserve for the entire day. Data type: Boolean |
| result.apply_to_shift | Flag that indicates whether shift-based reservations are enabled for the reservable module. Valid values: * true: Allow shift-based reservations. * false: Don't allow shift-based reservations. Data type: Boolean |
| result.browse_by_area_enabled | Flag that indicates whether users are able to search for reservable modules by area. Valid values: * true: Allow users to browse reservable modules by area. * false: Don't allow users to browse reservable modules by area. Data type: Boolean |
| result.browse_by_neighborhood_enabled | Only available if the Space Management - sn_wsd_spc_mgmt plugin is installed. Flag that indicates whether users are able to search in the reservable modules by neighborhood. Valid values: * true: Allow users to browse reservable modules by neighborhood. * false: Don't allow users to browse reservable modules by neighborhood. Data type: Boolean |
| result.browse_near_a_person_enabled | Flag that indicates whether users are able to search for reservable modules located by a specified person. Valid values: * true: Allow users to browse reservable modules near a person. * false: Don't allow users to browse reservable modules near a person. Data type: Boolean |
| result.buildingTreeData | Only returned if the is_buildings_tree_data_required query parameter is set to true. Hierarchy of the buildings associate with the reservable module. Hierarchy order: * Region: Located in the Region \[sn_wsd_core_region\] table. * Site: Located in the Site \[sn_wsd_core_site\] table. * Campus: Located in the Campus \[sn_wsd_core_campus\] table. * Building: Located in the Building \[sn_wsd_core_building\] table. {#wsd_resv_mod-GET-reserv_mod__ul_ppq_h34_stb} Each `children[ ]` node reflects a different building level/hiearchy: * buildingsTreeData: Region * buildingsTreeData.children: Site * buildingsTreeData.children.children: Campus * buildingsTreeData.children.children.children: Building Data type: Array of Objects "buildingsTreeData": [ { "children": [Array], "data": {Object}, "isSelectable": Boolean, "isValid": Boolean, "label": "String", "uId": "String" } ] |
| result.buildingsTreeData.children | Details on the site, campus, or building associated with the reservable module. Each of the parameters in all `children[ ]` nodes are the same. They just apply to different building entities and are only described one time in this section. Data type: Array of Objects "children": [ { "children": [Array], "data": {Object}, "isSelectable": Boolean, "isValid": Boolean, "label": "String", "uId": "String" } ] |
| result.buildingsTreeData.children.data | Details about the building entity. Data type: Object "data": { "sysId": "String", "table": "String", "timezone": {Object} } |
| result.buildingsTreeData.children.data.sys_id | Sys_id of the associated building entity. Data type: String |
| result.buildingsTreeData.children.data.table | Name of the table in which the building entity record identified in the sys_id is located. Data type: String |
| result.buildingsTreeData.children.data.timezone | Details about the time zone of the building entity. "timezone": { "displayValue": "String", "value": "String" } |
| result.buildingsTreeData.children.data.timezone.displayValue | Display value in the record for the time zone. Data type: String |
| result.buildingsTreeData.children.data.timezone.value | Internal value in the record for the time zone. Data type: String |
| result.buildingsTreeData.children.isSelectable | Flag that indicates whether the associated building entity is available (selectable) for the reservable model. Valid values: * true: Building entity is available for the reservable module. * false: Building entity isn't available for the reservable module. Data type: Boolean |
| result.buildingsTreeData.children.isValid | Flag that indicates whether the associated building entity is valid for the reservable model. Valid values: * true: Building entity is valid for the reservable module. * false: Building entity isn't valid for the reservable module. Data type: Boolean |
| result.buildingsTreeData.children.label | Name of the building entity. Data type: String |
| result.buildingsTreeData.children.uId | Sys_id of the associated building entity record. Data type: String |
| result.buildingSysIds | List of sys_ids of the buildings associated with the reservable module. Data type: Array of Strings |
| result.checkin_before_minutes | Amount of time before a reservation starts that a user can check into their reservation. Unit: Minutes Data type: Number |
| result.display_number_of_attendees | Flag that indicates whether users can specify the number of attendees in the reservation. Valid values: * true: Users can specify the number of attendees. * false: Users can't specify the display number of attendees. Data type: Boolean |
| result.display_on_behalf_of | Flag that indicates whether reservations can be made on behalf of someone else. Valid values: * true: On behalf of supported. * false: On behalf of not supported. Data type: Boolean |
| result.display_sensitivity | Flag that indicates whether users can set the sensitivity of the reservation, such as normal or private. Valid values: * true: Able to set sensitivity. * false: Not able to set sensitivity. Defaults to normal. Data type: Boolean |
| result.display_value | Display value of the reservable module. Data type: String |
| result.enable_browse_by_area | Flag that indicates whether users are able to search for reservable modules by area. Same as browse_by_area_enabled. Valid values: * true: Allow users to browse reservable modules by area. * false: Don't allow users to browse reservable modules by area. {#wsd_resv_mod-GET-reserv_mod__ul_unz_q1r_stb} Data type: Boolean |
| result.enable_browse_by_neighborhood | Flag that indicates whether users are able to search for reservable modules by neighborhood. Valid values: * true: Allow users to browse reservable modules by neighborhood. * false: Don't allow users to browse reservable modules by neighborhood. Data type: Boolean |
| result.enable_browse_near_a_person | Flag that indicates whether users are able to search for reservable modules located by a specified person. Same as browse_near_a_person_enabled. Valid values: * true: Allow users to browse reservable modules near a person. * false: Don't allow users to browse reservable modules near a person. {#wsd_resv_mod-GET-reserv_mod__ul_zx4_s1r_stb} Data type: Boolean |
| result.enable_facet_filter | Flag that indicates whether facet filtering on workplace items is enabled. When enabled, the filter options that appear are based on the search results. Only the items that are available in the generated search result are available to users for selection in the filter. Valid values: * true: Facet filters are enabled. * false: Facet filters aren't enabled. Data type: Boolean |
| result.enable_group_reservations | Flag that indicates whether users can make a group reservation. Valid values: * true: Able to make group reservations. * false: Not able to make group reservations. Data type: Boolean |
| result.enable_ical_generation | Flag that indicates whether users can generate an iCalendar for the reservation. Valid values: * true: iCalendar generation allowed. * false: iCalendar generation isn't allowed. Data type: Boolean |
| result.font_awesome_icon | Name of the font icon attached to the reservable module. Data type: String |
| result.inline_title | Inline title of the reservable module. The title appears in line with the descriptive text on the Workplace service portal. Data type: String |
| result.layout_mapping | Details about the structure of the layout mapping of locations. Use this data to lay out the information in the UI. Data type: Object "layout_mapping": { "body": [Array], "description": [Array], "image": "String", "subtitle": [Array], "subtitle_asc": [Array], "title": [Array] } |
| result.layout_mapping.body | Placeholder for mapping the front-end UI data. Data type: Array of Objects "body": [ { "field": "String", "field_to_display": "String", "icon": "String", "label": "String" } ] |
| result.layout_mapping.body.field | Placeholder for mapping the front-end UI data. Data type: String |
| result.layout_mapping.body.field_to_display | Placeholder for mapping the front-end UI data. Data type: String |
| result.layout_mapping.body.icon | Placeholder for mapping the front-end UI data. Data type: String |
| result.layout_mapping.body.label | Placeholder for mapping the front-end UI data. Data type: String |
| result.layout_mapping.description | Placeholder for mapping the front-end UI data. Description of the layout mapping. Data type: Array |
| result.layout_mapping.image | Placeholder for mapping the front-end UI data. Data type: String |
| result.layout_mapping.subtitle | Placeholder for mapping the front-end UI data. Data type: Array |
| result.layout_mapping.subtitle_asc | Placeholder for mapping the front-end UI data. Data type: Array |
| result.layout_mapping.title | Placeholder for mapping the front-end UI data. Data type: Array |
| result.max_days_in_future | Maximum number of the days in the future that a user can reserve the reservable module. Data type: Number |
| result.max_occurrences | Maximum number of recurring reservation occurrences if recurring reservations are available for the reservable module. Data type: Number |
| result.name | Name of the reservable module. Data type: String |
| result.nbhBuildingIds | Only returned if the Space Management plugin is installed, the browse_by_neighborhood_enabled parameter is set to true, and the neighborhood parameter is passed in the query parameters. List of sys_ids of the buildings associated with the reservable module and configured for the neighborhood. Data type: Array of Strings |
| result.nbhBuildingsData | Only returned if the Space Management plugin is installed, the browse_by_neighborhood_enabled parameter is set to true, and the neighborhood parameter is passed in the query parameters. List of sys_ids of the buildings associated with the reservable module and configured for the neighborhood. Each building element also contains a list of sys_ids of the corresponding floors available for the building. For example: "nbhBuildingsData": { "4703a4cedb3650106c731dcd13961945": [ "0f9e304edb7650106c731dcd13961911" ], "6c0364cedb3650106c731dcd13961927": [ "b23328cedb3650106c731dcd139619f9" ] } Records associated with the building sys_ids are located in the Building \[sn_wsd_core_building\] table. Records associated with the floor sys_ids are located in the Floor \[sn_wsd_core_floor\] table. Data type: Array of Objects |
| result.nbhBuildingsTreeData | Only returned if the Space Management plugin is installed, the browse_by_neighborhood_enabled parameter is set to true, and the neighborhood parameter is passed in the query parameters. Hierarchy of the buildings associate with the reservable module and neighborhood. Data type: Array of Objects "buildingsTreeData": [ { "children": [Array], "data": {Object}, "isSelectable": Boolean, "isValid": Boolean, "label": "String", "uId": "String" } ] Hierarchy order: * Region: Located in the Region \[sn_wsd_core_region\] table. * Site: Located in the Site \[sn_wsd_core_site\] table. * Campus: Located in the Campus \[sn_wsd_core_campus\] table. * Building: Located in the Building \[sn_wsd_core_building\] table. |
| result.nbhBuildingsTreeData.children | Describes the hierarchy of the children associated with the building. Each `children[]` node reflects a different building level/hierarchy: * buildingsTreeData: Region * buildingsTreeData.children: Site * buildingsTreeData.children.children: Campus * buildingsTreeData.children.children.children: Building Data type: Array "children": [ { "children": [Array], "data": {Object}, "isSelectable": Boolean, "isValid": Boolean, "label": "String", "uId": "String" } ] The parameters in the `children[]` array are the same as those in the nbhBuildingsTreeData object, just for the associated location type; region, site, campus, or building. |
| result.nbhBuildingsTreeData.data | Details about the associated entity; region, site, campus, or building. Data type: Object "data": { "sys_id": "String", "table": "String", "timezone": {Object} } |
| result.nbhBuildingsTreeData.data.sysId | Sys_id of the associated entity record. Data type: String |
| result.nbhBuildingsTreeData.data.table | Table in which the associated record is located. Data type: String |
| result.nbhBuildingsTreeData.data.timezone | Information about the time zone in which the associated entity resides. Data type: Object "timezone": { "displayValue": "String", "value": "String" } |
| result.nbhBuildingsTreeData.data.timezone.displayValue | Time zone value to use in a user interface. Data type: String |
| result.nbhBuildingsTreeData.data.timezone.value | Internal time zone value. Data type: String |
| result.nbhBuildingsTreeData.isSelectable | Flag that indicates whether the associated entity is available (selectable) for the reservable model. Valid values: * true: Entity is available for the reservable module. * false: Entity isn't available for the reservable module. Data type: Boolean |
| result.nbhBuildingsTreeData.isValid | Flag that indicates whether the associated entity is valid for the reservable model. Valid values: * true: Entity is valid for the reservable module. * false: Entity isn't valid for the reservable module. Data type: Boolean |
| result.nbhBuildingsTreeData.label | Name of the reservable view. Data type: String |
| result.nbhBuildingsTreeData.uId | Sys_id of the associated entity. Data type: String |
| result.override_approval_policy | Option to specify how to implement the approval policy. Choices are as follows: * No override: The approval policy is implemented as set in the Requires approval field of a workplace space or room. * Always require approval: The approval policy is required regardless of what is set in the Requires approval field of a workplace space or room. * Never require approval: The approval policy is removed regardless of what is set in the Requires approvall field of a workplace space or room. Data type: String |
| result.require_cancel_notes | Flag that indicates whether users must enter a cancellation note before cancelling a reservable module. Valid values: * true: Cancellation note required. * false: Cancellation note not required. Data type: Boolean |
| result.require_cc_dept_check | Flag that indicates whether to check if there's a cost center or department mismatch between the workspace item and the logged in user. Valid values: * true: Check for a mismatch. * false: Don't check for a mismatch. Data type: Boolean |
| result.require_subject | Flag that indicates whether the user must enter a subject when making the reservation. Valid values: * true: Subject required. * false: Subject isn't required. Data type: Boolean |
| result.reservable_columns | List of the columns of a reservable. Located in the Workplace Location \[sn_wsd_core_workplace_location\] table. Data type: Array |
| result.reservable_container_field | Level of the container, such as a group of desks in a specific area. Data type: String |
| result.reservable_filter | Filter conditions used to filter out reservable items in the associated Reservable table. Reservable table is a field in the Reservable Module \[sn_wsd_rsv_reservable_module\] table. These filter conditions were applied to the table contained in the field Reservable table. Data type: String |
| result.reservable_quantity_field | Reservable quantity of all the spaces. The quantity is used when assigning neighbourhood spaces to an area. For additional information, see [Assign neighborhood spaces to an area](https://www.servicenow.com/docs/access?context=add-neighbourhood-spaces-to-an-area&version=xanadu&pubname=xanadu-employee-service-management&ft:locale=en-US). Data type: String |
| result.reservable_table | Table that contains the reservable workplace items. Data type: String |
| result.reservable_type | Type of the reservable item, such as location. Data type: String |
| result.reservable_views | Details about the different views associated with the reservable module, such as card view or schedule view. Located in the Reservable View \[sn_wsd_rsv_reservable_view\] table. Data type: Object "reservable_views": { "iconClass": "String", "isDefault": Boolean, "label": "String", "order": Number, "type": "String" } |
| result.reservable_views.iconClass | Icon class of the reservable view. Data type: String |
| result.reservable_views.isDefault | Flag that indicates whether to make this reservable view the default for reservable modules. Valid values: * true: Make default. * false: Don't make default. Data type: Boolean |
| result.reservable_views.label | Name of the reservable view. Data type: String |
| result.reservable_views.order | Order in which the views are displayed for the reservable module in the UI. The lower order number come first in the UI. In case of the same order number, it is assigned random ordering. Data type: Number |
| result.reservable_views.type | Backend name of the reservable view. Used for internal processing. Data type: String |
| result.reservation_paths | Reservation paths associated with the reservable modules such as Browse all, Browse near a person. Data type: Array of Objects "reservation_paths": [ { "displayValue": "String", "value": "String" } |
| result.reservation_paths.displayValue | Display value for the reservation path, such as "Browse near a person". Data type: String |
| result.reservation_paths.value | Internal value for the reservation path, such as "browse_near_a_person". Data type: String |
| result.search_limit | Maximum number of search results to return when a user searches for a workplace location. Data type: Number |
| result.selection_type | Type of selection to display in the search results. Can be one of the following options: * Specific unit: The search result displays every workplace item. * Container: The search result displays the parent or container of the workplace items. Data type: String |
| result.short_description | Brief description of the reservable module. Data type: String |
| result.show_map_view | Flag that indicates whether to enable the map view for reservable modules. Valid values: * true: Enable map view. * false: Don't enable map view. {#wsd_resv_mod-GET-reserv_mod__ul_dsq_ftg_rtb} Data type: Boolean |
| result.sys_id | Sys_id of the reservable module. Data type: String |
| result.timeSlots | Details about the time slots associated for a reservable module. Data type: Array of Objects [ { "name": "String", "short_description": "String", "slot_end": "String", "slot_start": "String", "sys_id": "String" } ] |
| result.timeSlots.name | Name of the time slot. Data type: String |
| result.timeSlots.short_description | Brief description of the time slot. Data type: String |
| result.timeSlots.slot_end | End time of the time slot. Data type: String |
| result.timeSlots.slot_start | Start time of the slot. Data type: String |
| result.timeSlots.sys_id | Sys_id of the time slot record. Located in the Time Slot \[sn_wsd_rsv_time_slot\] table. Data type: String |
| result.title | Title of the reservable module. Data type: String |
| result.virtual_meeting_provider | Details about the virtual provider associated with the reservable module. Data type: Object "virtual_meeting_provider": { "display_value": "String", "sys_id": "String" } |
| result.virtual_meeting_provider.display_value | Display value of the virtual meeting provider. Data type: String |
| result.virtual_meeting_provider.sys_id | Sys_id of the virtual meeting provider. Data type: String |
[ ]
{#wsd_resv_mod-GET-reserv_mod__id_w24_zwn_1yb}
### cURL request
This code example shows how to request a reservable module with the buildings tree data.
curl "http://instance.servicenow.com/api/sn_wsd_rsv/reservable_module/5db44502dbb650106c731dcd13961937&is_buildings_tree_data_required=true" \
--request GET \
--header "Accept:application/json" \
--user "username":"password"
Response body:
{
"result": {
"sys_id": "5db44502dbb650106c731dcd13961937", "name": "Desks",
"title": "Desks",
"inline_title": "desk",
"font_awesome_icon": "fa-desktop",
"reservable_table": "sn_wsd_core_space",
"reservable_filter": "active=true^is_reservable=true^location_type=5f017383eb512010b89bfdfc9c5228c8^building.is_reservable=true^floor.is_reservable=true^EQ",
"short_description": "Reserve a single desks",
"reservable_type": "location",
"require_subject": null,
"require_cancel_notes": false,
"virtual_meeting_provider": {
"sys_id": "e33d9e6853c201103cf7ddeeff7b1205",
"display_value": "Template"
},
"allow_invitees": null,
"display_number_of_attendees": null,
"display_on_behalf_of": null,
"display_sensitivity": null,
"max_days_in_future": "90",
"allow_whole_day": "1",
"selection_type": "unit",
"reservable_container_field": null,
"reservable_quantity_field": null,
"apply_to_shift": null,
"max_occurrences": "90",
"enable_facet_filter": false,
"search_limit": 10000,
"enable_ical_generation": null,
"enable_group_reservations": null,
"enable_browse_near_a_person": "1",
"enable_browse_by_area": "1",
"enable_browse_by_neighborhood": "1",
"show_map_view": false,
"require_cc_dept_check": false,
"display_value": "Desks",
"browse_near_a_person_enabled": true,
"browse_by_area_enabled": true,
"browse_by_neighborhood_enabled": true,
"reservable_columns": [
"sys_id",
"external_id",
"email",
"name",
"title",
"description",
"image",
"number",
"site",
"campus",
"building",
"floor",
"area",
"capacity",
"reservable_quantity",
"location_type",
"order",
"requires_check_in",
"is_reservable"
],
"layout_mapping": {
"title": [
"name"
],
"description": [
"description"
],
"subtitle": [
"campus",
"building",
"floor",
"area"
],
"subtitle_asc": [
"area",
"floor",
"building",
"campus"
],
"image": "image",
"body": [
{
"label": "Capacity",
"icon": "fa-users",
"field": "capacity",
"field_to_display": ""
},
{
"label": "Standard services",
"icon": "fa-check",
"field": "standard_services",
"field_to_display": "name"
},
{
"label": "Reservable purposes",
"icon": "fa-tags",
"field": "reservable_purposes",
"field_to_display": "name"
}
]
},
"timeSlots": [
{
"sys_id": "d5331cf2dbb5f01038e42b24ca961906",
"name": "All day",
"short_description": "8am - 6pm",
"slot_start": "08:00",
"slot_end": "18:00"
},
{
"sys_id": "de131cf2dbb5f01038e42b24ca961931",
"name": "Before noon",
"short_description": "8am - 12pm",
"slot_start": "08:00",
"slot_end": "12:00"
},
{
"sys_id": "6e99ab5ddbb930102e8e853e68961929",
"name": "After noon",
"short_description": "1pm - 6pm",
"slot_start": "13:00",
"slot_end": "18:00"
}
],
"buildingSysIds": [
"9e0364cedb3650106c731dcd1396192b"
],
"buildingsTreeData": [
{
"isValid": true,
"label": "Europe",
"uId": "2d626c4edb3650106c731dcd1396194b",
"isSelectable": false,
"children": [
{
"isValid": true,
"label": "Western Europe",
"uId": "b17220cedb3650106c731dcd1396197a",
"isSelectable": false,
"children": [
{
"isValid": true,
"label": "Amsterdam Campus",
"uId": "44d2e0cedb3650106c731dcd13961988",
"isSelectable": false,
"children": [
{
"isValid": true,
"label": "AMS-B1",
"uId": "9e0364cedb3650106c731dcd1396192b",
"isSelectable": true,
"children": [],
"data": {
"sysId": "9e0364cedb3650106c731dcd1396192b",
"table": "sn_wsd_core_building",
"timezone": {
"value": "Europe/Amsterdam",
"displayValue": "Europe/Amsterdam"
}
}
}
],
"data": {
"sysId": "44d2e0cedb3650106c731dcd13961988",
"table": "sn_wsd_core_campus",
"timezone": null
}
}
],
"data": {
"sysId": "b17220cedb3650106c731dcd1396197a",
"table": "sn_wsd_core_site",
"timezone": null
}
}
],
"data": {
"sysId": "2d626c4edb3650106c731dcd1396194b",
"table": "sn_wsd_core_region",
"timezone": null
}
}
],
"reservable_views": [
{
"type": "card",
"label": "Card view",
"iconClass": "fa-th-large",
"isDefault": true,
"order": "1"
},
{
"type": "schedule",
"label": "Schedule view",
"iconClass": "fa-calendar-o",
"isDefault": false,
"order": "2"
}
],
"checkin_before_minutes": 30,
"reservation_paths": [
{
"value": "browse_all",
"displayValue": "Browse all"
},
{
"value": "browse_near_a_person",
"displayValue": "Browse near a person"
},
{
"value": "browse_by_area",
"displayValue": "Browse by area"
}
],
"override_approval_policy": "never_required"
}
}