# "Preferences" Endpoints - GET Preferences for the current user

**URL:** <https://community.toggl.com/t/preferences-endpoints-get-preferences-for-the-current-user/175>\
**Category:** API References\
**Tags:** api, endpoints, parameters, get, preferences\
**Created:** [November 21, 2024, 12:39pm UTC](https://community.toggl.com/t/preferences-endpoints-get-preferences-for-the-current-user/175 "2024-11-21T12:39:38Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![Support](https://yyz2.discourse-cdn.com/flex012/user_avatar/community.toggl.com/support/32/1577_2.png) [@Support](https://community.toggl.com/u/Support)\
**Post date:** [November 21, 2024, 12:39pm UTC](https://community.toggl.com/t/preferences-endpoints-get-preferences-for-the-current-user/175/1 "2024-11-21T12:39:38Z")

</div>

```auto
https://api.track.toggl.com/api/v9/me/preferences

```

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.

- cURL
- Go
- Ruby
- JavaScript
- Python
- Rust

```auto
extern crate tokio;extern crate serde_json;use reqwest::{Client};use reqwest::header::{CONTENT_TYPE};#[tokio::main]async fn main() -> Result<(), reqwest::Error> { let client = Client::new().basic_auth("<email>", "<password>"); let json = client.request(Method::GET, "https://api.track.toggl.com/api/v9/me/preferences".to_string()) .header(CONTENT_TYPE, "application/json") .send() .await? .json() .await?; println!("{:#?}", json); Ok(())}

```

### Response[​](https://engineering.toggl.com/docs/api/preferences/#response)

#### 200[​](https://engineering.toggl.com/docs/api/preferences/#200)

| Name | Type | Description |
| --- | --- | --- |
| activity\_timeline\_display\_activity | boolean | - |
| activity\_timeline\_grouping\_interval | string | - |
| activity\_timeline\_grouping\_method | string | - |
| activity\_timeline\_recording\_level | string | - |
| activity\_timeline\_sync\_events | boolean | - |
| alpha\_features | Array of object | will be omitted if empty |
| analyticsAdvancedFilters | boolean | will be omitted if empty |
| auto\_tracker\_delay\_enabled | boolean | - |
| auto\_tracker\_delay\_in\_seconds | integer | - |
| automatic\_tagging | boolean | - |
| autotracking\_enabled | boolean | - |
| beginningOfWeek | integer | will be omitted if empty |
| calendar\_snap\_duration | string | - |
| calendar\_snap\_initial\_location | string | - |
| calendar\_visible\_hours\_end | integer | - |
| calendar\_visible\_hours\_start | integer | - |
| calendar\_zoom\_level | string | - |
| cell\_swipe\_actions\_enabled | boolean | - |
| 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 |
| default\_project\_id | integer | - |
| default\_task\_id | integer | - |
| displayDensity | string | will be omitted if empty |
| distinctRates | string | will be omitted if empty |
| duration\_format | string | - |
| duration\_format\_on\_timer\_duration\_field | boolean | - |
| edit\_popup\_integration\_timer | boolean | - |
| extension\_send\_error\_reports | boolean | - |
| extension\_send\_usage\_statistics | boolean | - |
| firstSeenBusinessPromo | integer | will be omitted if empty |
| focus\_app\_on\_time\_entry\_started | boolean | - |
| focus\_app\_on\_time\_entry\_stopped | boolean | - |
| haptic\_feedback\_enabled | boolean | - |
| hide\_keyboard\_shortcut | boolean | will be omitted if empty |
| idle\_detection\_enabled | boolean | - |
| idle\_detection\_interval\_in\_minutes | integer | - |
| inactivity\_behavior | string | - |
| is\_goals\_view\_expanded | boolean | - |
| is\_goals\_view\_shown | boolean | - |
| is\_summary\_total\_view\_visible | boolean | - |
| keep\_mini\_timer\_on\_top | boolean | - |
| keep\_window\_on\_top | boolean | - |
| keyboard\_increment\_timer\_page | integer | - |
| keyboard\_shortcuts\_enabled | boolean | will be omitted if empty |
| keyboard\_shortcuts\_share\_time\_entries | boolean | - |
| macos\_auto\_tracking\_rules | Array of object | - |
| macos\_show\_hide\_toggl\_keyboard\_shortcut | object | - |
| macos\_stop\_continue\_keyboard\_shortcut | object | - |
| manualEntryMode | string | will be omitted if empty |
| manualMode | boolean | will be omitted if empty |
| manualModeOverlaySeen | boolean | will be omitted if empty |
| modify\_on\_start\_time\_change | string | - |
| offlineMode | string | will be omitted if empty |
| pg\_time\_zone\_name | string | - |
| pomodoro\_auto\_start\_break | boolean | - |
| pomodoro\_auto\_start\_focus | boolean | - |
| pomodoro\_break\_interval\_in\_minutes | integer | - |
| pomodoro\_break\_project\_id | integer | - |
| pomodoro\_break\_start\_sound\_enabled | boolean | - |
| pomodoro\_break\_tag\_id | integer | - |
| pomodoro\_countdown\_timer | boolean | - |
| pomodoro\_enabled | boolean | - |
| pomodoro\_focus\_interval\_in\_minutes | integer | - |
| pomodoro\_focus\_sound | string | - |
| pomodoro\_global\_sound\_enabled | boolean | - |
| pomodoro\_interval\_end\_sound | boolean | - |
| pomodoro\_interval\_end\_volume | integer | - |
| pomodoro\_longer\_break\_duration\_in\_minutes | integer | - |
| pomodoro\_prevent\_screen\_lock | boolean | - |
| pomodoro\_rounds\_before\_longer\_break | integer | - |
| pomodoro\_session\_start\_sound\_enabled | boolean | - |
| pomodoro\_show\_notifications | boolean | - |
| pomodoro\_stop\_timer\_at\_interval\_end | boolean | - |
| pomodoro\_track\_breaks\_as\_time\_entries | boolean | - |
| projectDashboardActivityMode | string | will be omitted if empty |
| project\_shortcut\_enabled | boolean | - |
| record\_timeline | boolean | - |
| remember\_last\_project | string | - |
| reminder\_days | string | - |
| reminder\_enabled | boolean | - |
| reminder\_interval\_in\_minutes | integer | - |
| reminder\_period | string | - |
| reminder\_snoozing\_in\_minutes | integer | - |
| 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 |
| run\_app\_on\_startup | boolean | - |
| running\_entry\_warning | string | - |
| running\_timer\_notification\_enabled | boolean | - |
| 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\_daily\_project\_invites | boolean | - |
| send\_product\_emails | boolean | - |
| send\_timer\_notifications | boolean | - |
| send\_weekly\_report | boolean | - |
| sharing\_shortcut\_enabled | boolean | - |
| showTimeInTitle | boolean | will be omitted if empty |
| show\_all\_entries | boolean | - |
| show\_changelog | boolean | - |
| show\_description\_in\_menu\_bar | boolean | - |
| show\_dock\_icon | boolean | - |
| show\_events\_in\_calendar | boolean | - |
| show\_project\_in\_menu\_bar | boolean | - |
| show\_qr\_scanner | boolean | - |
| show\_seconds\_in\_menu\_bar | boolean | - |
| show\_timeline\_in\_day\_view | boolean | will be omitted if empty |
| show\_timer\_in\_menu\_bar | boolean | - |
| show\_today\_total\_in\_menu\_bar | boolean | - |
| show\_total\_billable\_hours | boolean | will be omitted if empty |
| show\_weekend\_on\_timer\_page | boolean | will be omitted if empty |
| show\_workouts\_in\_calendar | boolean | - |
| sleep\_behaviour | string | - |
| smart\_alerts\_option | string | - |
| snowballReportRounding | string | will be omitted if empty |
| stack\_times\_on\_manual\_mode\_after | string | - |
| start\_automatically | boolean | - |
| start\_shortcut\_mode | string | - |
| stop\_at\_specific\_time | boolean | - |
| stop\_automatically | boolean | - |
| stop\_entry\_on\_shutdown | boolean | - |
| stop\_specified\_time | string | - |
| stopped\_timer\_notification\_enabled | boolean | - |
| suggestions\_enabled | boolean | - |
| 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 |
| summary\_total\_mode | string | - |
| tags\_shortcut\_enabled | boolean | - |
| theme | string | will be omitted if empty |
| time\_entry\_display\_mode | string | - |
| time\_entry\_ghost\_suggestions\_enabled | boolean | - |
| time\_entry\_invitations\_notification\_enabled | boolean | - |
| time\_entry\_start\_stop\_input\_mode | string | - |
| 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 |
| use\_mini\_timer | boolean | - |
| 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 |
| windows\_auto\_tracking\_rules | Array of object | - |
| windows\_show\_hide\_toggl\_keyboard\_shortcut | object | - |
| windows\_stop\_continue\_keyboard\_shortcut | object | - |
| windows\_stop\_start\_keyboard\_shortcut | object | - |
| windows\_theme | string | - |
| workout\_default\_project\_id | integer | - |
| workout\_default\_tag\_id | integer | - |

##### alpha\_features[​](https://engineering.toggl.com/docs/api/preferences/#alpha_features)

| Name | Type | Description |
| --- | --- | --- |
| 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 |

##### macos\_auto\_tracking\_rules[​](https://engineering.toggl.com/docs/api/preferences/#macos_auto_tracking_rules)

| Name | Type | Description |
| --- | --- | --- |
| id | string | - |
| keyword | string | - |
| project\_id | integer | - |
| task\_id | integer | - |

##### macos\_show\_hide\_toggl\_keyboard\_shortcut[​](https://engineering.toggl.com/docs/api/preferences/#macos_show_hide_toggl_keyboard_shortcut)

| Name | Type | Description |
| --- | --- | --- |
| key | integer | - |
| modifiers | integer | - |

##### macos\_stop\_continue\_keyboard\_shortcut[​](https://engineering.toggl.com/docs/api/preferences/#macos_stop_continue_keyboard_shortcut)

| Name | Type | Description |
| --- | --- | --- |
| key | integer | - |
| modifiers | integer | - |

##### windows\_auto\_tracking\_rules[​](https://engineering.toggl.com/docs/api/preferences/#windows_auto_tracking_rules)

| Name | Type | Description |
| --- | --- | --- |
| billable | boolean | - |
| description | string | - |
| enabled | boolean | - |
| id | string | - |
| parameters | object | - |
| project\_id | integer | - |
| skip\_when\_timer\_is\_running | boolean | - |
| start\_without\_confirmation | boolean | - |
| tag\_ids | Array of integer | - |
| task\_id | integer | - |
| type | integer | - |

##### parameters[​](https://engineering.toggl.com/docs/api/preferences/#parameters)

| Name | Type | Description |
| --- | --- | --- |
| duration | string | - |
| keyword | string | - |
| keyword\_mode | string | - |
| time\_of\_day | string | - |
| week\_days | string | - |

##### windows\_show\_hide\_toggl\_keyboard\_shortcut[​](https://engineering.toggl.com/docs/api/preferences/#windows_show_hide_toggl_keyboard_shortcut)

| Name | Type | Description |
| --- | --- | --- |
| key | integer | - |
| modifiers | integer | - |

##### windows\_stop\_continue\_keyboard\_shortcut[​](https://engineering.toggl.com/docs/api/preferences/#windows_stop_continue_keyboard_shortcut)

| Name | Type | Description |
| --- | --- | --- |
| key | integer | - |
| modifiers | integer | - |

##### windows\_stop\_start\_keyboard\_shortcut[​](https://engineering.toggl.com/docs/api/preferences/#windows_stop_start_keyboard_shortcut)

| Name | Type | Description |
| --- | --- | --- |
| key | integer | - |
| modifiers | integer | - |

#### 403[​](https://engineering.toggl.com/docs/api/preferences/#403)

User does not have access to this resource.

#### 500[​](https://engineering.toggl.com/docs/api/preferences/#500)

Internal Server Error