---
title: "GET /memberships"
method: GET
path: "/memberships"
---

# GET /memberships

`GET /memberships`

Lists all memberships resources within the caller's account.

## Query parameters

- `nextToken` string
- `maxResults` integer
- `status` 'ACTIVE' | 'REMOVED' | 'COLLABORATION_DELETED'

## Response `200`

Success

- ListMembershipsOutput
  - `nextToken` string — The pagination token that's used to fetch the next set of results.
  - `membershipSummaries` MembershipSummary[], required — The list of memberships returned from the ListMemberships operation.
    - `id` string, required — The unique ID for the membership's collaboration.
    - `arn` string, required — The unique ARN for the membership.
    - `collaborationArn` string, required — The unique ARN for the membership's associated collaboration.
    - `collaborationId` string, required — The unique ID for the membership's collaboration.
    - `collaborationCreatorAccountId` string, required — The identifier of the Amazon Web Services principal that created the collaboration. Currently only supports Amazon Web Services account ID.
    - `collaborationCreatorDisplayName` string, required — The display name of the collaboration creator.
    - `collaborationName` string, required — The name for the membership's collaboration.
    - `createTime` string, date-time, required — The time when the membership was created.
    - `updateTime` string, date-time, required — The time the membership metadata was last updated.
    - `status` 'ACTIVE' | 'REMOVED' | 'COLLABORATION_DELETED', required — The status of the membership.
    - `memberAbilities` MemberAbility[], required — The abilities granted to the collaboration member.
    - `mlMemberAbilities` object — Provides a summary of the ML abilities for the collaboration member.
      - `customMLMemberAbilities` CustomMLMemberAbility[], required — The custom ML member abilities for a collaboration member.
    - `paymentConfiguration` object, required — The payment responsibilities accepted by the collaboration member.
      - `queryCompute` object, required — The payment responsibilities accepted by the collaboration member for query compute costs.
        - `isResponsible` boolean, required — <p>Indicates whether the collaboration member has accepted to pay for query compute costs (<code>TRUE</code>) or has not accepted to pay for query compute costs (<code>FALSE</code>).</p> <p>If the collaboration creator has not specified anyone to pay for query compute costs, then the member who can query is the default payer. </p> <p>An error message is returned for the following reasons: </p> <ul> <li> <p>If you set the value to <code>FALSE</code> but you are responsible to pay for query compute costs. </p> </li> <li> <p>If you set the value to <code>TRUE</code> but you are not responsible to pay for query compute costs. </p> </li> </ul>
      - `machineLearning` object — The payment responsibilities accepted by the collaboration member for machine learning costs.
        - `modelTraining` object — The payment responsibilities accepted by the member for model training.
          - `isResponsible` boolean, required — <p>Indicates whether the collaboration member has accepted to pay for model training costs (<code>TRUE</code>) or has not accepted to pay for model training costs (<code>FALSE</code>).</p> <p>If the collaboration creator has not specified anyone to pay for model training costs, then the member who can query is the default payer. </p> <p>An error message is returned for the following reasons: </p> <ul> <li> <p>If you set the value to <code>FALSE</code> but you are responsible to pay for model training costs. </p> </li> <li> <p>If you set the value to <code>TRUE</code> but you are not responsible to pay for model training costs. </p> </li> </ul>
        - `modelInference` object — The payment responsibilities accepted by the member for model inference.
          - `isResponsible` boolean, required — <p>Indicates whether the collaboration member has accepted to pay for model inference costs (<code>TRUE</code>) or has not accepted to pay for model inference costs (<code>FALSE</code>).</p> <p>If the collaboration creator has not specified anyone to pay for model inference costs, then the member who can query is the default payer. </p> <p>An error message is returned for the following reasons: </p> <ul> <li> <p>If you set the value to <code>FALSE</code> but you are responsible to pay for model inference costs. </p> </li> <li> <p>If you set the value to <code>TRUE</code> but you are not responsible to pay for model inference costs. </p> </li> </ul>
        - `syntheticDataGeneration` object — The payment configuration for synthetic data generation for this machine learning membership.
          - `isResponsible` boolean, required — Indicates if this membership is responsible for paying for synthetic data generation.
      - `jobCompute` object — The payment responsibilities accepted by the collaboration member for job compute costs.
        - `isResponsible` boolean, required — <p>Indicates whether the collaboration member has accepted to pay for job compute costs (<code>TRUE</code>) or has not accepted to pay for query and job compute costs (<code>FALSE</code>).</p> <p>There can be one or more members who are designated as payer candidates for queries and jobs. </p> <p>An error message is returned for the following reasons: </p> <ul> <li> <p>If you set the value to <code>FALSE</code> but you are responsible to pay for query and job compute costs. </p> </li> <li> <p>If you set the value to <code>TRUE</code> but you are not responsible to pay for query and job compute costs. </p> </li> </ul>

## Other responses

- `480` — InternalServerException
- `481` — ValidationException
- `482` — ThrottlingException
- `483` — 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)