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

# GET /invitations

`GET /invitations`

Retrieves information about the Amazon Macie membership invitations that were received by an account.

## Query parameters

- `maxResults` integer
- `nextToken` string

## Response `200`

Success

- ListInvitationsResponse
  - `invitations` Invitation[] — An array of objects, one for each invitation that was received by the account.
    - `accountId` string — The Amazon Web Services account ID for the account that sent the invitation.
    - `invitationId` string — The unique identifier for the invitation.
    - `invitedAt` string, date-time — The date and time, in UTC and extended ISO 8601 format, when the invitation was sent.
    - `relationshipStatus` 'Enabled' | 'Paused' | 'Invited' | 'Created' | 'Removed' | 'Resigned' | 'EmailVerificationInProgress' | 'EmailVerificationFailed' | 'RegionDisabled' | 'AccountSuspended' — The status of the relationship between the account that sent the invitation and the account that received the invitation.
  - `nextToken` string — The string to use in a subsequent request to get the next page of results in a paginated response. This value is null if there are no additional pages.

## Other responses

- `480` — ValidationException
- `481` — InternalServerException
- `482` — ServiceQuotaExceededException
- `483` — AccessDeniedException
- `484` — ResourceNotFoundException
- `485` — ThrottlingException
- `486` — ConflictException

---

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