---
title: "GET /app-instance-users/{appInstanceUserArn}/endpoints"
method: GET
path: "/app-instance-users/{appInstanceUserArn}/endpoints"
---

# GET /app-instance-users/{appInstanceUserArn}/endpoints

`GET /app-instance-users/{appInstanceUserArn}/endpoints`

Lists all the <code>AppInstanceUserEndpoints</code> created under a single <code>AppInstanceUser</code>.

## Path parameters

- `appInstanceUserArn` string, password, required

## Query parameters

- `max-results` integer
- `next-token` string, password

## Response `200`

Success

- ListAppInstanceUserEndpointsResponse
  - `AppInstanceUserEndpoints` AppInstanceUserEndpointSummary[] — The information for each requested <code>AppInstanceUserEndpoint</code>.
    - `AppInstanceUserArn` string — The ARN of the <code>AppInstanceUser</code>.
    - `EndpointId` string — The unique identifier of the <code>AppInstanceUserEndpoint</code>.
    - `Name` string, password — The name of the <code>AppInstanceUserEndpoint</code>.
    - `Type` 'APNS' | 'APNS_SANDBOX' | 'GCM' — The type of the <code>AppInstanceUserEndpoint</code>.
    - `AllowMessages` 'ALL' | 'NONE' — BBoolean that controls whether the <code>AppInstanceUserEndpoint</code> is opted in to receive messages. <code>ALL</code> indicates the endpoint will receive all messages. <code>NONE</code> indicates the endpoint will receive no messages.
    - `EndpointState` object — A read-only field that represent the state of an <code>AppInstanceUserEndpoint</code>.
      - `Status` 'ACTIVE' | 'INACTIVE', required — Enum that indicates the Status of an <code>AppInstanceUserEndpoint</code>.
      - `StatusReason` 'INVALID_DEVICE_TOKEN' | 'INVALID_PINPOINT_ARN' — The reason for the <code>EndpointStatus</code>.
  - `NextToken` string, password — The token passed by previous API calls until all requested endpoints are returned.

## Other responses

- `480` — BadRequestException
- `481` — ForbiddenException
- `482` — ThrottledClientException
- `483` — UnauthorizedClientException
- `484` — ServiceUnavailableException
- `485` — ServiceFailureException

---

[API](https://skmtc.net/aws/apis/chime-sdk-identity.md) · [All operations](https://skmtc.net/aws/apis/chime-sdk-identity/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/chime-sdk-identity/revisions/5ac0320cd9af/schema)