--- title: "createAllotmentBlock" method: POST path: "/createAllotmentBlock" tags: ["AllotmentBlocks"] --- # createAllotmentBlock `POST /createAllotmentBlock` Retreive allotment blocks @apiQuery {Integer} propertyID Property ID ## Response `200` 200 Response - PostCreateAllotmentBlockResponse - `startDate` string, date — Date on or after which each returned allotmentBlock applies - `endDate` string, date — Date on or before which each returned allotmentBlock applies - `success` boolean — Returns if the request could be completed - `data` object[] — Allotment Blocks - `propertyID` string — Property ID associated to the allotment block - `allotmentBlockCode` string — Allotment block code - `allotmentBlockStatus` string — Allotment block status - `allotmentBlockName` string — Allotment block name - `allotmentBlockId` string — Allotment block ID - `rateType` string — Rate type for the allotment block - `ratePlanId` string — Rate plan ID if applicable - `allotmentType` string — the type of allotment block - `groupId` string — Group profile ID associated to the allotment block - `groupCode` string — Group profile code associated to the allotment block - `eventId` string — Event ID associated to the allotment block - `eventCode` string — Event code associated to the allotment block - `isAutoRelease` boolean — If the allotment block is configured for auto-release - `autoRelease` object — auto-release data if applicable - `releaseType` 'all_dates' | 'by_day' | 'by_interval' — The type of auto-release - `releaseDays` integer — The number of days prior to the end of the allotment block to begin releasing dates from the allotment block - `releaseTime` string — The hour to being the auto-release in HH:00 format, e.g. '00:00', '01:00'... - `allotmentIntervals` object[] — array of interval data by room type - `policyId` string — Policy ID associated with the interval - `roomTypeId` string — Room type ID - `startDate` string, date — Interval start date - `endDate` string, date — Interval end date - `availability` object — Interval availability data by day in interval - `date` string, date — Day within interval - `blockRemaining` integer — Number of units remaining for the room type for this day - `blockAllotted` integer — Total number of units available for the room type for this day. Note: this value is ignored for based_on_availability allotment types, which always use full property availability. - `blockConfirmed` integer — Number of units booked for the room type for this day - `rate` string — the price - `guestPricing` object — Guest pricing data if applicable. Note: the number of results varies here based on the occupancy settings and custom guest pricing for the room type. - `adult1` string — Price for adult 1 - `adult2` string — Price for adult 2 - `adult3` string — Price for adult 3 - `child1` string — Price for child 1 - `child2` string — Price for child 2 - `child3` string — Price for child 3 - `rooms` string[] — Array of room IDs assigned to this date - `restrictions` object — Interval restrictions if applicable - `minLos` integer — Minimum length of stay requirement - `maxLos` integer — Maximum length of stay requirement - `cutOffDays` integer — How many days before arrival should the guests be required to book - `lastMinuteBookingDays` integer — Hoe many days before the arrival guests are allowed to book - `closedToArrival` integer — If the interval dates are closed for arrival - `closedToDeparture` integer — If the interval dates are closed for departure - `splitInventory` boolean, nullable — Whether split inventory is enabled for this room type. When true, the linked physical room types are individually bookable within the allotment block, with their availability drawn from the allotment capacity of this room type. - `shoulderDatesBefore` integer, nullable — Number of shoulder days before the event start date. - `shoulderDatesAfter` integer, nullable — Number of shoulder days after the event end date. - `shoulderDatesRateId` string, nullable — Rate plan ID applied during shoulder date periods. - `resources` object[] — Space resource quotes (always present; empty array when flag off or no quotes) - `id` string — Resource quote ID - `resourceTypeId` string — Resource type ID - `resourceId` string, nullable — Resource ID (null for quantity-based) - `resourceTypeQuantity` integer, nullable — Quantity of resources - `startAt` string — Start date-time (ISO-8601) - `endAt` string — End date-time (ISO-8601) - `intervalRate` integer, nullable — Rate in cents (e.g. 15000 = $150.00) - `intervalType` 'per_interval' | 'per_rental', nullable — Interval type - `confirmed` boolean — Whether the resource quote is confirmed - `adults` integer — Number of adults - `children` integer — Number of children - `inventoryStrategy` string, nullable — Inventory strategy - `allotmentQuantityTotal` integer, nullable — Total allotment quantity - `allotmentQuantityConsumed` integer, nullable — Consumed allotment quantity - `resourceType` object, nullable — Resource type details - `resource` object, nullable — Resource details - `title` string, nullable — Title - `notes` string, nullable — Notes - `eventIntervalPeriod` string, nullable — Event interval period - `eventIntervalAmount` integer, nullable — Event interval amount - `intervalQuantity` integer, nullable — Interval quantity - `currencyCode` string, nullable — Currency code - `netAmount` object, nullable — Net amount - `subtotal` object, nullable — Subtotal - `inclusiveTaxesAndFeesAmount` object, nullable — Inclusive taxes and fees - `exclusiveTaxesAndFeesAmount` object, nullable — Exclusive taxes and fees - `total` object, nullable — Total - `taxes` object[] — Applied taxes - `fees` object[] — Applied fees --- [API](https://skmtc.net/cloudbeds/apis/cloudbeds-api.md) · [All operations](https://skmtc.net/cloudbeds/apis/cloudbeds-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cloudbeds/cloudbeds-api/versions/2faa857793e8/schema)