AllotmentBlocks

getAllotmentBlocks

Changed on

Retrieve allotment blocks

get/getAllotmentBlocks

Request

  • Base URL
    https://api.cloudbeds.com/api/v1.3
  • URL
    https://api.cloudbeds.com/api/v1.3/getAllotmentBlocks
  • Auth
    • API key in header x-api-key
    • or OAuth 2
      Authorization code
      Scopes: read:allotmentBlock

Query parameters

propertyIDstring required

Property ID (optional, by default all authorized properties will be included)

allotmentBlockCodestring

Allotment block code

allotmentBlockNamestring

Allotment block name

eventProfileIDstring

GPS (Group Profile Service) external profile ID. Returns all allotment blocks linked to this GPS profile.

eventCodestring

An event (group profile) code

allotmentBlockStatus'definite' | 'tentative' | 'lead' | 'cancelled'

Allotment block status(es)

allotmentBlockType'aggregate' | 'allotment'

The type of allotment block

roomTypeIDstring

Filters allotment blocks with the supplied Room Type ID.

pageSizeinteger

Number of allotment blocks to return per page (min: 1, max: 100)

pageNumberinteger

Which page in the results to access

startDatestring date

Lower limit for the block's date range. That range includes shoulder dates, so it can begin before the earliest interval startDate. A block is returned only if its date range starts on or after this date.

endDatestring date

Upper limit for the block's date range. That range includes shoulder dates, so it can end after the latest interval endDate. A block is returned only if its date range ends on or before this date.

forUpdateboolean

If false (default) this will show the effective availability on each date. If true, will read raw availability from the allotment intervals.

includeResourcesboolean

When true, each block in the response will include a resources[] array with associated space resource quotes. Requires the spaces-allotment-blocks feature flag to be enabled for the property; when the flag is off, resources[] will be empty even if the param is true.

includeShoulderDatesboolean

When true, each interval's availability[] also includes the interval's shoulder dates, and every availability entry carries isShoulderDate. On a shoulder date blockAllotted and blockRemaining are 0 and blockConfirmed is the number of rooms picked up against the block for that night, so it may exceed blockAllotted. Requires the property's shoulder-dates feature to be enabled; when it is off, availability[] holds only the interval's own dates even if the param is true. Has no effect when forUpdate=true: that mode reads raw interval availability, which carries no shoulder dates.

Response

200 Response

successboolean

Returns if the request could be completed

countinteger

Number of allotment blocks returned

totalinteger

Total number of allotment blocks

Changes

    • warning

      deleted the query request parameter groupCode

    • warning

      deleted the query request parameter groupProfileID

    • info

      added the new optional query request parameter eventProfileID

    • info

      added the new optional query request parameter includeShoulderDates

    • info

      added the optional property ////// to the response with the status

    • info

      added the optional property //// to the response with the status