---
title: "GET /collaborations/{collaborationIdentifier}/changeRequests"
method: GET
path: "/collaborations/{collaborationIdentifier}/changeRequests"
---

# GET /collaborations/{collaborationIdentifier}/changeRequests

`GET /collaborations/{collaborationIdentifier}/changeRequests`

Lists all change requests for a collaboration with pagination support. Returns change requests sorted by creation time.

## Path parameters

- `collaborationIdentifier` string, required

## Query parameters

- `status` 'PENDING' | 'APPROVED' | 'CANCELLED' | 'DENIED' | 'COMMITTED'
- `nextToken` string
- `maxResults` integer

## Response `200`

Success

- ListCollaborationChangeRequestsOutput
  - `collaborationChangeRequestSummaries` CollaborationChangeRequestSummary[], required — The list of collaboration change request summaries.
    - `id` string, required — The unique identifier for the change request.
    - `collaborationId` string, required — The unique identifier for the collaboration.
    - `createTime` string, date-time, required — The time when the change request was created.
    - `updateTime` string, date-time, required — The time when the change request was last updated.
    - `status` 'PENDING' | 'APPROVED' | 'CANCELLED' | 'DENIED' | 'COMMITTED', required — The current status of the change request.
    - `isAutoApproved` boolean, required — Whether the change request was automatically approved.
    - `changes` Change[], required — Summary of the changes in this change request.
      - `specificationType` 'MEMBER' | 'COLLABORATION', required — The type of specification for this change.
      - `specification` object, required — The specification details for this change.
        - `member` object — The member change specification when the change type is <code>MEMBER</code>.
          - `accountId` string, required — The Amazon Web Services account ID of the member to add to the collaboration.
          - `memberAbilities` MemberAbility[], required — <p>The abilities granted to the collaboration member. These determine what actions the member can perform within the collaboration.</p> <note> <p>The following values are currently not supported: <code>CAN_QUERY</code> and <code>CAN_RUN_JOB</code>. </p> <p>Set the value of <code>memberAbilities</code> to <code>[]</code> to allow a member to contribute data.</p> <p>Set the value of <code>memberAbilities</code> to <code>[CAN_RECEIVE_RESULTS]</code> to allow a member to contribute data and receive results.</p> </note>
          - `mlMemberAbilities` MLMemberAbilities — The ML member abilities for a collaboration member.
            - `customMLMemberAbilities` CustomMLMemberAbility[], required — The custom ML member abilities for a collaboration member.
          - `paymentConfiguration` PaymentConfiguration — An object representing the collaboration member's payment responsibilities set by the collaboration creator.
            - `queryCompute` object, required — The collaboration member's payment responsibilities set by the collaboration creator for query compute costs.
              - …
            - `machineLearning` object — An object representing the collaboration member's machine learning payment responsibilities set by the collaboration creator.
              - …
            - `jobCompute` object — The compute configuration for the job.
              - …
          - `displayName` string — Specifies the display name that will be shown for this member in the collaboration. While this field is required when inviting new members, it becomes optional when modifying abilities of existing collaboration members.
        - `collaboration` object — The collaboration configuration changes being requested. Currently, this only supports modifying which change types are auto-approved for the collaboration.
          - `autoApprovedChangeTypes` AutoApprovedChangeType[] — Defines requested updates to properties of the collaboration. Currently, this only supports modifying which change types are auto-approved for the collaboration.
      - `types` ChangeType[], required — The list of change types that were applied.
    - `approvals` object — Summary of approval statuses from all collaboration members for this change request.
  - `nextToken` string — The pagination token that's used to fetch the next set of results.

## Other responses

- `480` — ResourceNotFoundException
- `481` — InternalServerException
- `482` — ValidationException
- `483` — ThrottlingException
- `484` — AccessDeniedException

---

[API](https://skmtc.net/aws/apis/cleanrooms.md) · [All operations](https://skmtc.net/aws/apis/cleanrooms/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/cleanrooms/versions/17ce59ba806e/schema)