# Source assignments ## Get all source assignments (ver 2024-09-20) > #### Restricted! > > This operation is currently in beta-test and as such it is subject to change. Returns all Sources assigned to Reservations. Each reservation can have multiple sources. 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/sourceAssignments/getAll/2024-09-20` ```javascript { "ClientToken": "E0D439EE522F44368DC78E1BFB03710C-D24FB11DBE31D4621C4817E028D9E1D", "AccessToken": "C66EF7B239D24632943D115EDE9CB810-EA00F8FD8294692C940F6B5A8F9453D", "Client": "Sample Client 1.0.0", "ReservationIds": [ "9b59b50d-bd32-4ce5-add8-09ea0e1300e7" ], "UpdatedUtc": { "StartUtc": "2025-11-01T00:00:00Z", "EndUtc": "2025-11-30T00:00:00Z" }, "EnterpriseIds": [ "3fa85f64-5717-4562-b3fc-2c963f66afa6" ], "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. | | `ReservationIds` | array of string | optional, max 100 items | Unique identifiers of `Reservation`. | | `UpdatedUtc` | [Time interval](/connector-api/operations/_objects.md#time-interval) | optional, max length 1 month | Interval of source assignment last update date and time. | | `EnterpriseIds` | array of string | optional, max 1 item | Unique identifiers of the Enterprises. Required when using Portfolio Access Tokens, ignored otherwise. | | `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 { "SourceAssignments": [ { "Id": "c5e11f73-7e85-4a3c-9fe1-872014a10b43", "ReservationId": "9b59b50d-bd32-4ce5-add8-09ea0e1300e7", "SourceId": "22e42a59-b321-43f8-a5d1-af1f00e1bb8b", "IsPrimary": true, "UpdatedUtc": "2025-11-05T11:00:00Z" }, { "Id": "5411ffd5-72c6-4ab3-b179-708bcac73d08", "ReservationId": "9b59b50d-bd32-4ce5-add8-09ea0e1300e7", "SourceId": "bbe29c21-401a-4746-b97d-af1f00e1bb8b", "IsPrimary": false, "UpdatedUtc": "2025-11-11T05:00:00Z" } ], "Cursor": "5411ffd5-72c6-4ab3-b179-708bcac73d08" } ``` | Property | Type | Contract | Description | | ------------------- | ---------------------------------------------------------------------------------- | -------- | --------------------------------------------------------------------------------------------- | | `SourceAssignments` | array of [Source assignments (ver 2024-09-20)](#source-assignments-ver-2024-09-20) | required | Assignments between `Reservation` and `Source`. | | `Cursor` | string | optional | Opaque pagination cursor which can be used in `Limitation` to fetch newer source assignments. | #### Source assignments (ver 2024-09-20) | Property | Type | Contract | Description | | --------------- | ------- | -------- | -------------------------------------------------------------------------------------- | | `Id` | string | required | Unique identifier of the source assignment. | | `ReservationId` | string | required | Unique identifier of the `Reservation`. | | `SourceId` | string | required | Unique identifier of the `Source`. | | `IsPrimary` | boolean | required | Specifies whether the source is primary for the `Reservation`. | | `UpdatedUtc` | string | required | Date and time of the source assignment last update in UTC timezone in ISO 8601 format. | ## Get all source assignments Returns all Sources assigned to a Reservation group. Each reservation group can have multiple sources. 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/sourceAssignments/getAll` ```javascript { "ClientToken": "E0D439EE522F44368DC78E1BFB03710C-D24FB11DBE31D4621C4817E028D9E1D", "AccessToken": "C66EF7B239D24632943D115EDE9CB810-EA00F8FD8294692C940F6B5A8F9453D", "Client": "Sample Client 1.0.0", "ReservationGroupIds": [ "730d050c-8098-415a-95af-af2500a2de47" ], "UpdatedUtc": { "StartUtc": "2023-02-1T00:00:00Z", "EndUtc": "2023-02-28T00:00:00Z" }, "EnterpriseIds": [ "3fa85f64-5717-4562-b3fc-2c963f66afa6", "4d0201db-36f5-428b-8d11-4f0a65e960cc" ], "Limitation": { "Count": 10 } } ``` | 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. | | `ReservationGroupIds` | array of string | optional, max 1000 items | Unique identifiers of the `Reservation group`. | | `UpdatedUtc` | [Time interval](/connector-api/operations/_objects.md#time-interval) | optional, max length 3 months | Interval of `Reservation group` last update date and time. | | `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 { "SourceAssignments": [ { "Id": "670ef167-0380-4dd5-8dbb-af1500d3eb16", "ReservationGroupId": "730d050c-8098-415a-95af-af2500a2de47", "SourceId": "de6c3fcc-feb9-4385-92e0-af25008b864e", "IsPrimary": true }, { "Id": "da272c89-3afc-4e6f-ad12-af2500a2de79", "ReservationGroupId": "730d050c-8098-415a-95af-af2500a2de47", "SourceId": "04db79fa-3a31-47c3-ae25-af25008b864e", "IsPrimary": false } ], "Cursor": "da272c89-3afc-4e6f-ad12-af2500a2de79" } ``` | Property | Type | Contract | Description | | ------------------- | ------------------------------------------------ | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `SourceAssignments` | array of [Source assignment](#source-assignment) | required | Assignments between reservation group and sources. | | `Cursor` | string | required | Unique identifier of the last and hence oldest source assignment returned. This can be used in `Limitation` in a subsequent request to fetch the next batch of older source assignments. | #### Source assignment | Property | Type | Contract | Description | | -------------------- | ------- | -------- | ---------------------------------------------------------------------------------------------------------------------- | | `Id` | string | required | Unique identifier of the source assignement. | | `ReservationGroupId` | string | required | Unique identifier of the [Reservation group](/connector-api/operations/reservations.md#reservation-group). | | `SourceId` | string | required | Unique identifier of the [Source](/connector-api/operations/sources.md#source). | | `IsPrimary` | boolean | required | Specifies the primary source for the [Reservation group](/connector-api/operations/reservations.md#reservation-group). | --- # 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/sourceassignments.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.