---
title: "Get my preferences"
method: GET
path: "/api/account/preferences"
tags: ["Account"]
---

# Get my preferences

`GET /api/account/preferences`

Read the preferences of the logged in user.
- <https://lichess.org/account/preferences/game-display>
- <https://github.com/ornicar/lila/blob/master/modules/pref/src/main/Pref.scala>

## Response `200`

The preferences of the logged in user.

- object
  - `prefs` UserPreferences
    - `dark` boolean
    - `transp` boolean
    - `bgImg` string, uri
    - `is3d` boolean
    - `theme` 'blue' | 'blue2' | 'blue3' | 'blue-marble' | 'canvas' | 'wood' | 'wood2' | 'wood3' | 'wood4' | 'maple' | 'maple2' | 'brown' | 'leather' | 'green' | 'marble' | 'green-plastic' | 'grey' | 'metal' | 'olive' | 'newspaper' | 'purple' | 'purple-diag' | 'pink' | 'ic'
    - `pieceSet` 'cburnett' | 'merida' | 'alpha' | 'pirouetti' | 'chessnut' | 'chess7' | 'reillycraig' | 'companion' | 'riohacha' | 'kosal' | 'leipzig' | 'fantasy' | 'spatial' | 'california' | 'pixel' | 'maestro' | 'fresca' | 'cardinal' | 'gioco' | 'tatiana' | 'staunty' | 'governor' | 'dubrovny' | 'icpieces' | 'shapes' | 'letter'
    - `theme3d` 'Black-White-Aluminium' | 'Brushed-Aluminium' | 'China-Blue' | 'China-Green' | 'China-Grey' | 'China-Scarlet' | 'Classic-Blue' | 'Gold-Silver' | 'Light-Wood' | 'Power-Coated' | 'Rosewood' | 'Marble' | 'Wax' | 'Jade' | 'Woodi'
    - `pieceSet3d` 'Basic' | 'Wood' | 'Metal' | 'RedVBlue' | 'ModernJade' | 'ModernWood' | 'Glass' | 'Trimmed' | 'Experimental' | 'Staunton' | 'CubesAndPi'
    - `soundSet` 'silent' | 'standard' | 'piano' | 'nes' | 'sfx' | 'futuristic' | 'robot' | 'music' | 'speech'
    - `blindfold` integer
    - `autoQueen` integer — 1 = Never, 2 = When premoving, 3 = Always
    - `autoThreefold` integer — 0 = Never, 2 = When time remaining < 30 seconds, 3 = Always
    - `takeback` integer — 1 = Never, 2 = In casual games only, 3 = Always
    - `moretime` integer — 1 = Never, 2 = In casual games only, 3 = Always
    - `clockTenths` integer — 0 = Never, 1 = When remaining time less than 10 seconds, 2 = Always
    - `clockBar` boolean
    - `clockSound` boolean
    - `premove` boolean
    - `animation` integer — 0 = None, 1 = Fast, 2 = Normal, 3 = Slow
    - `pieceNotation` integer — 0 = Chess piece symbol, 1 = KQRBN Letter
    - `captured` boolean
    - `follow` boolean
    - `highlight` boolean
    - `destination` boolean
    - `coords` integer — 0 = No, 1 = Inside the board, 2 = Outside the board, 3 = All squares
    - `replay` integer
    - `challenge` integer
    - `message` integer
    - `submitMove` integer
    - `confirmResign` integer — 1 = Confirm resignation and draw offers, 0 = Do not confirm
    - `insightShare` integer
    - `keyboardMove` integer — 1 = input moves with the keyboard
    - `voiceMove` boolean
    - `zen` integer — 0 = No, 1 = yes, 2 = in-game only
    - `ratings` integer — 0 = Hide ratings, 1 = Show ratings, 2 = Show ratings except in-game
    - `moveEvent` integer
    - `rookCastle` integer — 0 = Move king two squares, 1 = Move king onto rook
    - `flairs` boolean — Show player flairs
    - `sayGG` 0 | 1 | 2 — 0 = No, 1 = When losing, 2 = When losing or drawing
  - `language` string

---

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