---
title: "Get scope"
method: GET
path: "/user-scope/{id}"
tags: ["User scope"]
---

# Get scope

`GET /user-scope/{id}`

Returns the current scope of permitted properties assigned to the specified user.

## Path parameters

- `id` string, required

## Response `200`

Scope retrieved successfully

- object
  - `allAssigned` boolean — True if the user is scoped to all listings in the account. When true, listingIds will not be present.
  - `listingIds` string[] — Array of listing IDs that the user is scoped to. Only present when allAssigned is false or undefined. Note: Either allAssigned or listingIds will always be present.

## Other responses

- `400` — Bad request — invalid user ID

---

[API](https://skmtc.net/guesty/apis/guesty-open-api.md) · [All operations](https://skmtc.net/guesty/apis/guesty-open-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/guesty/guesty-open-api/versions/7c62644070f2/schema)