---
title: "POST /members/list"
method: POST
path: "/members/list"
---

# POST /members/list

`POST /members/list`

List members associated with the Amazon Inspector delegated administrator for your organization.

## Request body

- object
  - `onlyAssociated` boolean — Specifies whether to list only currently associated members if <code>True</code> or to list all members within the organization if <code>False</code>.
  - `maxResults` integer — The maximum number of results the response can return. If your request would return more than the maximum the response will return a <code>nextToken</code> value, use this value when you call the action again to get the remaining results.
  - `nextToken` string — A token to use for paginating results that are returned in the response. Set the value of this parameter to null for the first request to a list action. If your response returns more than the <code>maxResults</code> maximum value it will also return a <code>nextToken</code> value. For subsequent calls, use the <code>nextToken</code> value returned from the previous request to continue listing results after the first page.

## Response `200`

Success

- ListMembersResponse
  - `members` Member[] — An object that contains details for each member account.
    - `accountId` string — The Amazon Web Services account ID of the member account.
    - `relationshipStatus` 'CREATED' | 'INVITED' | 'DISABLED' | 'ENABLED' | 'REMOVED' | 'RESIGNED' | 'DELETED' | 'EMAIL_VERIFICATION_IN_PROGRESS' | 'EMAIL_VERIFICATION_FAILED' | 'REGION_DISABLED' | 'ACCOUNT_SUSPENDED' | 'CANNOT_CREATE_DETECTOR_IN_ORG_MASTER' — The status of the member account.
    - `delegatedAdminAccountId` string — The Amazon Web Services account ID of the Amazon Inspector delegated administrator for this member account.
    - `updatedAt` string, date-time — A timestamp showing when the status of this member was last updated.
  - `nextToken` string — The pagination parameter to be used on the next list operation to retrieve more items.

## Other responses

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

---

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