---
description: Preferred common behaviors to be shared across clients.
---

# preferences

## View user preferences

<mark style="color:blue;">`GET`</mark> `https://mastodon.example/api/v1/preferences`

Preferences defined by the user in their account settings.\
\
**Returns:** Preferences by key and value\
**OAuth:** User token + `read:accounts`\
**Version history:**\
2.8.0 - added\


#### Headers

| Name          | Type   | Description          |
| ------------- | ------ | -------------------- |
| Authorization | string | Bearer \<user token> |

{% tabs %}
{% tab title="200 " %}
```javascript
{
  "posting:default:visibility": "public",
  "posting:default:sensitive": false,
  "posting:default:language": null,
  "reading:expand:media": "default",
  "reading:expand:spoilers": false
}
```
{% endtab %}

{% tab title="401 Incorrect Authorization header" %}
```javascript
{
  "error": "The access token is invalid"
}
```
{% endtab %}
{% endtabs %}
