---
title: "Signed-in account state"
method: GET
path: "/v1/account"
tags: ["Account"]
---

# Signed-in account state

`GET /v1/account`

## Request

- Base URL: `https://hootlens-api-368877148687.us-east1.run.app`
- URL: `https://hootlens-api-368877148687.us-east1.run.app/v1/account`
- Auth: HTTP bearer

What the signed-in person may do: whether the email is verified, whether they can add websites, and whether billing controls apply to them. Account management excludes personal access tokens, which receive 403.

Required token scopes are listed in x-hootlens-scopes. A signed-in person needs the matching permission on the site instead (the viewer and editor roles are presets of the permissions).

## Response `200`

The account state.

- Account
  - `emailVerified` boolean, required
  - `canCreateProjects` boolean, required
  - `canAccessWorkspace` boolean, required
  - `staff` unknown
  - `billing` object
    - `enabled` boolean, required

## Other responses

- `401`: The credential is missing, expired or revoked.
- `403`: The credential or the person's permissions on the site do not permit this action.
- `404`: The site, or the record inside it, does not exist or the caller is not a member (a non-member cannot tell the two apart).
- `429`: A rate limit or a per-site limit was reached.

---

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