---
title: "List app users"
method: GET
path: "/v1/spaces/{spaceId}/users"
tags: ["Spaces"]
---

# List app users

`GET /v1/spaces/{spaceId}/users`

## Request

- Base URL: `https://api.spacefast.com`
- URL: `https://api.spacefast.com/v1/spaces/{spaceId}/users`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `__Host-better-auth.session_token`
  - OAuth 2 (authorization code, authorization URL `https://api.spacefast.com/v1/auth/oauth2/authorize`, token URL `https://api.spacefast.com/v1/auth/oauth2/token`; client credentials, token URL `https://api.spacefast.com/v1/auth/oauth2/token`, scopes: `spaces:write`)

Lists the visitor accounts of this Space's app by page: `page`, `perPage` (default 20, at most 100), and an optional name or email `search`. Each account shows its status, email addresses, and linked sign-in providers. App accounts sign in to the published Space only; they never grant team or Space access. Requires permission to manage the Space.

## Path parameters

- `spaceId` string, required

## Query parameters

- `page` integer
- `perPage` integer
- `search` string

## Response `200`

Response for status 200

- object
  - `$schema` string, uri: Canonical JSON Schema URL for this response body. The server also sends it in the `Link: rel="describedby"` response header.
  - `data` object, required
    - `page` integer, required
    - `perPage` integer, required
    - `users` object[], required
      - `id` integer, required
      - `subject` string, required
      - `displayName` string, required
      - `status` 'active' | 'suspended' | 'deletion_requested' | 'deleted', required
      - `emails` object[], required
        - `id` string, required
        - `email` string, required
        - `primary` boolean, required
        - `verifiedAt` integer, nullable, required
      - `providers` object[], required
        - `id` string, required
        - `issuer` string, required

## Other responses

- `default`: Problem details (RFC 9457). Any 4xx/5xx response is one `application/problem+json` document.

---

[API](https://skmtc.dev/spacefast/apis/spacefast-api.md) · [All operations](https://skmtc.dev/spacefast/apis/spacefast-api/llms.txt) · [OpenAPI document](https://skmtc.dev/spacefast/apis/spacefast-api/revisions/bd165bc7c983?raw)