---
title: "Get Status"
method: GET
path: "/v1/auth/status"
tags: ["auth"]
---

# Get Status

`GET /v1/auth/status`

## Request

- Base URL: `https://app.tokumalabs.com/api`
- URL: `https://app.tokumalabs.com/api/v1/auth/status`
- Auth: OAuth 2
  - Password
  - Token URL: `v1/auth/token`

## Response `200`

Successful Response

- UserStatus
  - `user_id` string, required: User ID
  - `username` string, required: User username
  - `timezone` string, required: User timezone (IANA timezone identifier)
  - `display_name` string, nullable: User display name
  - `organization_id` string, required: Organization ID
  - `organization_name` string, required: Organization name
  - `office_id` string, required: Office ID
  - `office_name` string, required: Office name
  - `office_timezone` string, required: Office timezone (IANA timezone identifier)
  - `department_id` string, nullable: Department ID (if user belongs to a department)
  - `department_name` string, nullable: Department name (if user belongs to a department)
  - `position_id` string, nullable: Position ID (if user has a position)
  - `position_name` string, nullable: Position name (if user has a position)
  - `region_id` string, nullable: Region ID (if office belongs to a region)
  - `region_name` string, nullable: Region name (if office belongs to a region)
  - `target_per_day_minutes` integer, nullable: Daily target minutes for utilization calculation
  - `fiscal_year_start_month` integer, required: Organization fiscal year start month (1-12)
  - `fiscal_year_start_day` integer, required: Organization fiscal year start day (1-31)
  - `time_display_format` 'time' | 'decimal', required
  - `activity_codes_enabled` boolean, required: Whether activity codes feature is enabled for the organization
  - `default_billing_increment_minutes` integer: The firm's default billing increment in minutes — what a new matter starts with, and what an entry with no segment is computed with. A matter's own increment overrides it.
  - `default_billing_rounding_rule` string: The firm's default rounding rule: 'up', 'nearest' or 'down'
  - `feature_flags` object: User feature flags

## Other responses

- `400`: Validation error or domain rule violation.
- `401`: Missing, expired, or invalid authentication.
- `403`: Authenticated but not permitted.
- `404`: Resource not found.
- `409`: Resource state conflict (duplicate, illegal transition).
- `422`: Request body failed schema validation.
- `500`: Server-side failure.

---

[API](https://skmtc.dev/tokumalabs/apis/tokuma-user-api.md) - [All operations](https://skmtc.dev/tokumalabs/apis/tokuma-user-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tokumalabs/apis/tokuma-user-api/revisions/1f8201af459b?raw)