---
title: "Get account"
method: GET
path: "/v1/account"
tags: ["Account"]
---

# Get account

`GET /v1/account`

Returns the caller's account snapshot: the organization the request is scoped to, plus the user record and their role when the request was made by a real user (OAuth). API-key callers receive `user: null` and `role: null` because API keys aren't tied to a specific user.

## Response `200`

Account snapshot

- AccountResponse
  - `user` AccountUser, nullable, required — The user the request is acting on behalf of. `null` for API-key callers — API keys are org-scoped, not user-scoped.
    - `id` string, required — Stable user identifier across the API.
    - `email` string, required — Verified email address of the authenticated user.
    - `name` string, nullable, required — Display name, when set. `null` until the user completes onboarding.
    - `image` string, nullable, required — Profile image URL, when set.
  - `organization` AccountOrganization, required — Organization the request is scoped to.
    - `id` string, required — Stable organization identifier across the API.
    - `name` string, required — Human-readable organization name.
    - `slug` string, required — URL-safe slug. Regenerated when the organization is renamed — don't use it as a stable key.
  - `role` 'owner' | 'admin' | 'member' | 'null', nullable, required — Caller's role in the organization. `null` for API-key callers (no real user behind the credential).

## Other responses

- `400` — Validation error
- `401` — Unauthorized
- `404` — Not found

---

[API](https://skmtc.net/latitude-dev/apis/latitude.md) · [All operations](https://skmtc.net/latitude-dev/apis/latitude/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/latitude-dev/latitude/revisions/a0bf72a85607/schema)