# ListMembers
<a name="API_ListMembers"></a>

Retrieves the list of member accounts for a behavior graph.

For invited accounts, the results do not include member accounts that were removed from the behavior graph.

For the organization behavior graph, the results do not include organization accounts that the Detective administrator account has not enabled as member accounts.

## Request Syntax
<a name="API_ListMembers_RequestSyntax"></a>

```
POST /graph/members/list HTTP/1.1
Content-type: application/json

{
   "GraphArn": "string",
   "MaxResults": number,
   "NextToken": "string"
}
```

## URI Request Parameters
<a name="API_ListMembers_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_ListMembers_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [GraphArn](#API_ListMembers_RequestSyntax) **   <a name="detective-ListMembers-request-GraphArn"></a>
The ARN of the behavior graph for which to retrieve the list of member accounts.  
Type: String  
Pattern: `^arn:aws[-\w]{0,10}?:detective:[-\w]{2,20}?:\d{12}?:graph:[abcdef\d]{32}?$`   
Required: Yes

 ** [MaxResults](#API_ListMembers_RequestSyntax) **   <a name="detective-ListMembers-request-MaxResults"></a>
The maximum number of member accounts to include in the response. The total must be less than the overall limit on the number of results to return, which is currently 200.  
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 200.  
Required: No

 ** [NextToken](#API_ListMembers_RequestSyntax) **   <a name="detective-ListMembers-request-NextToken"></a>
For requests to retrieve the next page of member account results, the pagination token that was returned with the previous page of results. The initial request does not include a pagination token.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 1024.  
Required: No

## Response Syntax
<a name="API_ListMembers_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "MemberDetails": [ 
      { 
         "AccountId": "string",
         "AdministratorId": "string",
         "DatasourcePackageIngestStates": { 
            "string" : "string" 
         },
         "DisabledReason": "string",
         "EmailAddress": "string",
         "GraphArn": "string",
         "InvitationType": "string",
         "InvitedTime": "string",
         "MasterId": "string",
         "PercentOfGraphUtilization": number,
         "PercentOfGraphUtilizationUpdatedTime": "string",
         "Status": "string",
         "UpdatedTime": "string",
         "VolumeUsageByDatasourcePackage": { 
            "string" : { 
               "VolumeUsageInBytes": number,
               "VolumeUsageUpdateTime": "string"
            }
         },
         "VolumeUsageInBytes": number,
         "VolumeUsageUpdatedTime": "string"
      }
   ],
   "NextToken": "string"
}
```

## Response Elements
<a name="API_ListMembers_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [MemberDetails](#API_ListMembers_ResponseSyntax) **   <a name="detective-ListMembers-response-MemberDetails"></a>
The list of member accounts in the behavior graph.  
For invited accounts, the results include member accounts that did not pass verification and member accounts that have not yet accepted the invitation to the behavior graph. The results do not include member accounts that were removed from the behavior graph.  
For the organization behavior graph, the results do not include organization accounts that the Detective administrator account has not enabled as member accounts.  
Type: Array of [MemberDetail](API_MemberDetail.md) objects

 ** [NextToken](#API_ListMembers_ResponseSyntax) **   <a name="detective-ListMembers-response-NextToken"></a>
If there are more member accounts remaining in the results, then use this pagination token to request the next page of member accounts.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 1024.

## Errors
<a name="API_ListMembers_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
The request issuer does not have permission to access this resource or perform this operation.    
 ** ErrorCode **   
The SDK default error code associated with the access denied exception.  
 ** ErrorCodeReason **   
The SDK default explanation of why access was denied.  
 ** SubErrorCode **   
The error code associated with the access denied exception.  
 ** SubErrorCodeReason **   
 An explanation of why access was denied.
HTTP Status Code: 403

 ** InternalServerException **   
The request was valid but failed because of a problem with the service.  
HTTP Status Code: 500

 ** ResourceNotFoundException **   
The request refers to a nonexistent resource.  
HTTP Status Code: 404

 ** ValidationException **   
The request parameters are invalid.    
 ** ErrorCode **   
The error code associated with the validation failure.  
 ** ErrorCodeReason **   
 An explanation of why validation failed.
HTTP Status Code: 400

## Examples
<a name="API_ListMembers_Examples"></a>

### Example
<a name="API_ListMembers_Example_1"></a>

This example illustrates one usage of ListMembers.

#### Sample Request
<a name="API_ListMembers_Example_1_Request"></a>

```
POST /graph/members/list HTTP/1.1
Host: api.detective.us-west-2.amazonaws.com
Accept-Encoding: identity
Content-Length: 94
Authorization: AUTHPARAMS
X-Amz-Date: 20200124T193018Z
User-Agent: aws-cli/1.14.29 Python/2.7.9 Windows/8 botocore/1.8.33

{
 "GraphArn": "arn:aws:detective:us-east-1:111122223333:graph:027c7c4610ea4aacaf0b883093cab899"
}
```

### Example
<a name="API_ListMembers_Example_2"></a>

This example illustrates one usage of ListMembers.

#### Sample Response
<a name="API_ListMembers_Example_2_Response"></a>

```
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 586
Date: Fri, 24 Jan 2020 23:07:46 GMT
x-amzn-RequestId: 397d0549-0092-11e8-a0ee-a7f9aa6e7572
Connection: Keep-alive

{
 "MemberDetails": [ 
 { 
  "AccountId": "444455556666",
  "AdministratorId": "111122223333",
  "EmailAddress": "mmajor@example.com",
  "GraphArn": "arn:aws:detective:us-east-1:111122223333:graph:027c7c4610ea4aacaf0b883093cab899",
  "InvitedTime": "2020-01-24T12:35:0.1587Z",
  "MasterId": "111122223333",
  "PercentOfGraphUtilization": 5,
  "PercentOfGraphUtilizationUpdatedTime": 1586287843,
  "Status": "INVITED",
  "UpdatedTime": "2020-01-24T12:35:0.1587Z",
  "VolumeUsageInBytes": 500,
  "VolumeUsageUpdatedTime": "2020-01-26T11:15:24.129Z"
 },
 { 
  "AccountId": "123456789012",
  "AdministratorId": "111122223333",
  "EmailAddress": "jstiles@example.com",
  "GraphArn": "arn:aws:detective:us-east-1:111122223333:graph:027c7c4610ea4aacaf0b883093cab899",
  "InvitedTime": "2020-01-24T12:35:0.1587Z",
  "MasterId": "111122223333",
  "PercentOfGraphUtilization": 2,
  "PercentOfGraphUtilizationUpdatedTime": 1586287843,
  "Status": "ENABLED",
  "UpdatedTime": "2020-01-25T05:35:11.623Z",
  "VolumeUsageInBytes": 200,
  "VolumeUsageUpdatedTime": "2020-01-26T11:14:26.427Z"
 }
 ]
}
```

## See Also
<a name="API_ListMembers_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/detective-2018-10-26/ListMembers) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/detective-2018-10-26/ListMembers) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/detective-2018-10-26/ListMembers) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/detective-2018-10-26/ListMembers) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/detective-2018-10-26/ListMembers) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/detective-2018-10-26/ListMembers) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/detective-2018-10-26/ListMembers) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/detective-2018-10-26/ListMembers) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/detective-2018-10-26/ListMembers) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/detective-2018-10-26/ListMembers)