---
title: "Preferences for an specific client of the current user"
method: GET
path: "/me/preferences/{client}"
tags: ["preferences"]
---

# Preferences for an specific client of the current user

`GET /me/preferences/{client}`

## Request

- Base URL: `https://localhost:8080/api/v9`
- URL: `https://localhost:8080/api/v9/me/preferences/{client}`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/toggl/apis/toggl-api/docs/me/preferences/:client/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns user preferences and alpha features. The list of alpha features contains a full list of feature codes (every feature that exists in database) and the `enabled` flag specifying if that feature should be enabled or disabled for the user.

## Path parameters

- `client` 'desktop' | 'web', required

## Response `200`

Successful operation.

- ModelsAllPreferences
  - `alpha_features` ModelsAlphaFeature[]: will be omitted if empty
    - `alpha_feature_id` integer: Feature ID
    - `code` string: Feature code
    - `deleted_at` string: Time of deletion, omitted if empty
    - `description` string: Feature description, omitted if empty
    - `enabled` boolean: Whether the feature is enabled
  - `calendar_visible_hours_end` integer
  - `calendar_visible_hours_start` integer
  - `charts_view_type` string
  - `collapseDetailedReportEntries` boolean: will be omitted if empty
  - `collapseTimeEntries` boolean: will be omitted if empty
  - `dashboards_view_type` string
  - `date_format` string
  - `decimal_separator` string: will be omitted if empty
  - `displayDensity` string: will be omitted if empty
  - `distinctRates` string: will be omitted if empty
  - `duration_format` string
  - `duration_format_on_timer_duration_field` boolean
  - `firstSeenBusinessPromo` integer: will be omitted if empty
  - `hide_keyboard_shortcut` boolean: will be omitted if empty
  - `keyboard_increment_timer_page` integer
  - `keyboard_shortcuts_enabled` boolean: will be omitted if empty
  - `manualEntryMode` string: will be omitted if empty
  - `manualMode` boolean: will be omitted if empty
  - `manualModeOverlaySeen` boolean: will be omitted if empty
  - `offlineMode` string: will be omitted if empty
  - `pg_time_zone_name` string
  - `projectDashboardActivityMode` string: will be omitted if empty
  - `record_timeline` boolean
  - `reportRounding` boolean: will be omitted if empty
  - `reportRoundingDirection` string: will be omitted if empty
  - `reportRoundingStepInMinutes` integer: will be omitted if empty
  - `reportsHideWeekends` boolean: will be omitted if empty
  - `seenFollowModal` boolean: will be omitted if empty
  - `seenFooterPopup` boolean: will be omitted if empty
  - `seenProjectDashboardOverlay` boolean: will be omitted if empty
  - `seenTogglButtonModal` boolean: will be omitted if empty
  - `send_product_emails` boolean
  - `send_timer_notifications` boolean
  - `send_weekly_report` boolean
  - `showTimeInTitle` boolean: will be omitted if empty
  - `show_timeline_in_day_view` boolean: will be omitted if empty
  - `show_total_billable_hours` boolean: will be omitted if empty
  - `show_weekend_on_timer_page` boolean: will be omitted if empty
  - `snowballReportRounding` string: will be omitted if empty
  - `stack_times_on_manual_mode_after` string
  - `summaryReportAmounts` string: will be omitted if empty
  - `summaryReportDistinctRates` boolean: will be omitted if empty
  - `summaryReportGrouping` string: will be omitted if empty
  - `summaryReportSortAsc` boolean: will be omitted if empty
  - `summaryReportSortField` string: will be omitted if empty
  - `summaryReportSubGrouping` string: will be omitted if empty
  - `theme` string: will be omitted if empty
  - `timeofday_format` string
  - `timerView` string: will be omitted if empty
  - `timerViewMobile` string: will be omitted if empty
  - `toSAcceptNeeded` boolean: ToSAcceptNeeded represents the trigger for new ToS accept dialog
  - `visibleFooter` string: will be omitted if empty
  - `webTimeEntryStarted` boolean: will be omitted if empty
  - `webTimeEntryStopped` boolean: will be omitted if empty
  - `weeklyReportGrouping` string: will be omitted if empty
  - `weeklyReportValueToShow` string: will be omitted if empty

## Other responses

- `400`: Unknown client.
- `403`: User does not have access to this resource.
- `500`: Internal Server Error

---

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