# Availability adjustments ## Get all availability adjustments Returns all availability adjustments. Note this operation uses [Pagination](/connector-api/guidelines/pagination.md) and supports [Portfolio Access Tokens](/connector-api/concepts/multi-property.md). ### Request `[PlatformAddress]/api/connector/v1/availabilityAdjustments/getAll` ```javascript { "ClientToken": "E0D439EE522F44368DC78E1BFB03710C-D24FB11DBE31D4621C4817E028D9E1D", "AccessToken": "C66EF7B239D24632943D115EDE9CB810-EA00F8FD8294692C940F6B5A8F9453D", "Client": "Sample Client 1.0.0", "AvailabilityAdjustmentIds": [ "e19297af-373e-4701-b4ea-afae0129bded", "7413724a-6c48-46d4-ab3a-afae01280999" ], "UpdatedUtc": { "StartUtc": "2023-02-18T18:00:10.155Z", "EndUtc": "2023-02-20T18:00:10.155Z" }, "ActivityStates": [ "Active", "Deleted" ], "EnterpriseIds": [ "3fa85f64-5717-4562-b3fc-2c963f66afa6", "4d0201db-36f5-428b-8d11-4f0a65e960cc" ], "Limitation": { "Count": 100 } } ``` | Property | Type | Contract | Description | | --------------------------- | ------------------------------------------------------------------------------- | ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | | `ClientToken` | string | required | Token identifying the client application. | | `AccessToken` | string | required | Access token of the client application. | | `Client` | string | required | Name and version of the client application. | | `EnterpriseIds` | array of string | optional, max 1000 items | Unique identifiers of the Enterprises. If not specified, the operation returns data for all enterprises within scope of the Access Token. | | `AvailabilityAdjustmentIds` | array of string | optional, max 1000 items | Unique identifiers of the requested [Availability adjustments](#availability-adjustment). | | `UpdatedUtc` | [Time interval](/connector-api/operations/_objects.md#time-interval) | optional, max length 3 months | Interval in which the availability adjustments were updated. | | `ActivityStates` | array of [Activity state](/connector-api/operations/_objects.md#activity-state) | optional | Whether to return only active, only deleted, or both types of record. If not specified, only active records will be returned. | | `Limitation` | [Limitation](/connector-api/guidelines/pagination.md#limitation) | required | Limitation on the quantity of data returned and optional Cursor for the starting point of data. | ### Response ```javascript { "AvailabilityAdjustments": [ { "Id": "e19297af-373e-4701-b4ea-afae0129bded", "AvailabilityBlockId": "5ee074b1-6c86-48e8-915f-c7aa4702086f", "ResourceCategoryId": "773d5e42-de1e-43a0-9ce6-f940faf2303f", "StartUtc": null, "EndUtc": null, "FirstTimeUnitStartUtc": "2021-10-14T00:00:00Z", "LastTimeUnitStartUtc": "2021-10-17T00:00:00Z", "UnitCount": 6, "ActivityState": "Active", "ReleaseOverrideUtc": "2021-10-13T00:00:00Z", "UpdatedUtc": "2021-10-21T13:32:32Z", "IsActive": false, "PaxCounts": null, "FirstTimeUnitReleaseUtc": "2021-10-13T00:00:00Z" }, { "Id": "7413724a-6c48-46d4-ab3a-afae01280999", "AvailabilityBlockId": null, "ResourceCategoryId": "773d5e42-de1e-43a0-9ce6-f940faf2303f", "StartUtc": null, "EndUtc": null, "FirstTimeUnitStartUtc": "2023-02-19T23:00:00Z", "LastTimeUnitStartUtc": "2023-02-23T23:00:00Z", "UnitCount": 5, "ActivityState": "Deleted", "ReleaseOverrideUtc": null, "UpdatedUtc": "2023-02-28T23:00:00Z", "IsActive": false, "PaxCounts": null, "FirstTimeUnitReleaseUtc": null } ], "Cursor": "7413724a-6c48-46d4-ab3a-afae01280999" } ``` | Property | Type | Contract | Description | | ------------------------- | ------------------------------------------------------------ | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `AvailabilityAdjustments` | array of [Availability adjustment](#availability-adjustment) | required | Availability adjustments. | | `Cursor` | string | optional | Unique identifier of the item one newer in time order than the items to be returned. If Cursor is not specified, i.e. null, then the latest or most recent items will be returned. | #### Availability adjustment | Property | Type | Contract | Description | | ------------------------- | -------------------------------------------------------------------------- | --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `Id` | string | required | Unique identifier of the [Availability adjustment](#availability-adjustment). | | `AvailabilityBlockId` | string | optional | Unique identifier of the [Availability block](/connector-api/operations/availabilityblocks.md#availability-block) which the availability adjustment belongs to. | | `ResourceCategoryId` | string | required | Unique identifier of the [Resource category](/connector-api/operations/resources.md#resource-category) whose availability is updated. | | `FirstTimeUnitStartUtc` | string | required | Start of the time interval, expressed as the timestamp for the start of the first [time unit](/connector-api/operations/services.md#time-unit), in UTC timezone ISO 8601 format. | | `LastTimeUnitStartUtc` | string | required | End of the time interval, expressed as the timestamp for the start of the last [time unit](/connector-api/operations/services.md#time-unit), in UTC timezone ISO 8601 format. | | `UnitCount` | integer | required | Adjustment value applied on the interval. | | `ReleaseOverrideUtc` | string | optional | Exact moment the availability adjustment is released if set; overrides the release strategy of the associated availability block. | | `UpdatedUtc` | string | required | Last update date and time of the adjustment in UTC timezone in ISO 8601 format. | | `IsActive` | boolean | required | Whether the availability adjustment is still active. | | `PaxCounts` | array of [PaxCount](/connector-api/operations/services.md#paxcount) | optional, max 5 items | Collection of predicted occupancy of availability adjustments. Relates to how many adjustments are assigned to each count of guests. | | `FirstTimeUnitReleaseUtc` | string | optional | Exact moment the first time unit of the availability adjustment is released based on `ReleaseOverrideUtc` or the `ReleaseStrategy` of the associated availability block, or the `OperationalEditableHistoryInterval` of the associated enterprise if not set, or `null` if `AvailabilityBlockId` is `null`. | | ~~`StartUtc`~~ | ~~string~~ | ~~optional~~ | ~~Start of the interval in UTC timezone in ISO 8601 format.~~ **Deprecated!** | | ~~`EndUtc`~~ | ~~string~~ | ~~optional~~ | ~~End of the interval in UTC timezone in ISO 8601 format.~~ **Deprecated!** | | ~~`ActivityState`~~ | [~~Activity state~~](/connector-api/operations/_objects.md#activity-state) | ~~required~~ | ~~Shows whether the availability adjustment is active or deleted.~~ **Deprecated!** Use `IsActive` instead. | --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.mews.com/connector-api/operations/availabilityadjustments.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.