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

# GET /spaces

`GET /spaces`

Returns a list of AWS re:Post Private private re:Posts in the account with some information about each private re:Post.

## Query parameters

- `nextToken` string
- `maxResults` integer

## Response `200`

Success

- ListSpacesOutput
  - `spaces` SpaceData[], required — An array of structures that contain some information about the private re:Posts in the account.
    - `spaceId` string, required — The unique ID of the private re:Post.
    - `arn` string, required — The ARN of the private re:Post.
    - `name` string, password, required — The name for the private re:Post.
    - `description` string, password — The description for the private re:Post. This is used only to help you identify this private re:Post.
    - `status` string, required — The creation/deletion status of the private re:Post.
    - `configurationStatus` 'CONFIGURED' | 'UNCONFIGURED', required — The configuration status of the private re:Post.
    - `vanityDomainStatus` 'PENDING' | 'APPROVED' | 'UNAPPROVED', required — This approval status of the custom subdomain.
    - `vanityDomain` string, required — This custom subdomain that you use to access your private re:Post. All custom subdomains must be approved by AWS before use.
    - `randomDomain` string, required — The AWS generated subdomain of the private re:Post.
    - `tier` 'BASIC' | 'STANDARD', required — The pricing tier of the private re:Post.
    - `storageLimit` integer, required — The storage limit of the private re:Post.
    - `createDateTime` string, date-time, required — The date when the private re:Post was created.
    - `deleteDateTime` string, date-time — The date when the private re:Post was deleted.
    - `userKMSKey` string — The custom AWS KMS key ARN that’s used for the AWS KMS encryption.
    - `userCount` integer — The number of onboarded users to the private re:Post.
    - `contentSize` integer — The content size of the private re:Post.
    - `supportedEmailDomains` object — <p/>
      - `enabled` 'ENABLED' | 'DISABLED' | 'NOT_ALLOWED' — <p/>
      - `allowedDomains` EmailDomain[] — <p/>
  - `nextToken` string — The token that you use when you request the next set of private re:Posts.

## Other responses

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

---

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