Availability adjustments

Get all availability adjustments

Returns all availability adjustments. Note this operation uses Pagination and supports Portfolio Access Tokens.

Request

[PlatformAddress]/api/connector/v1/availabilityAdjustments/getAll

{
  "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.
UpdatedUtc	Time interval	optional, max length 3 months	Interval in which the availability adjustments were updated.
ActivityStates	array of 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	required	Limitation on the quantity of data returned and optional Cursor for the starting point of data.

Response

{
  "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	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.
AvailabilityBlockId	string	optional	Unique identifier of the Availability block which the availability adjustment belongs to.
ResourceCategoryId	string	required	Unique identifier of the 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, 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, 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	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	required	Shows whether the availability adjustment is active or deleted. Deprecated! Use IsActive instead.