GET /me/settings/
Get the current user's settings.
Resource Information
| Method | GET |
|---|---|
| URL | https://public-api.wordpress.com/rest/v1.1/me/settings/ |
| Requires authentication? | Yes |
Query Parameters
| Parameter | Type | Description |
|---|---|---|
| context | (string) |
|
| http_envelope | (bool) |
|
| pretty | (bool) |
|
| meta | (string) | Optional. Loads data from the endpoints found in the 'meta' part of the response. Comma-separated list. Example: meta=site,likes |
| fields | (string) | Optional. Returns specified fields only. Comma-separated list. Example: fields=ID,title |
| callback | (string) | An optional JSONP callback function. |
Response Parameters
| Parameter | Type | Description |
|---|---|---|
| enable_translator | (bool) | Is in-page translation enabled for the current user? |
| surprise_me | (bool) | Is "Surprise Me" mode enabled for the current user? |
| post_post_flag | (bool) | Is Post-post is enabled for the current user? |
| holidaysnow | (bool) | Is holiday snow enabled for the current user? - (deprecated) |
| user_login | (string) | Get the current user's username. |
| display_name | (string) | Get the current user's display name. |
| first_name | (string) | Get the current user's first name. |
| last_name | (string) | Get the current user's last name. |
| description | (string) | Get the current user's About Me HTML. |
| user_email | (string) | Get the current user's email address. |
| user_email_change_pending | (bool) | Is an email change pending for the current user? |
| new_user_email | (string) | Get the email address a pending change would switch to. |
| user_URL | (url) | Get the current user's public profile URL setting. |
| language | (string) | Get the current user's interface language code. |
| avatar_URL | (url) | Get the current user's Gravatar image URL. |
| primary_site_ID | (int) | Get the current user's primary site ID. |
| comment_like_notification | (bool) | Are comment likes notification emails enabled for the current user? |
| mentions_notification | (bool) | Are mentions notification emails enabled for the current user? |
| subscription_delivery_email_default | (string) | Get the default email delivery frequency for new subscriptions (never, instantly, daily or weekly). |
| subscription_delivery_jabber_default | (bool) | Will new follows include jabber subscription? |
| subscription_delivery_mail_option | (string) | Get how subscription emails should be formatted: as HTML (html) or as plain text (text). |
| subscription_delivery_day | (int) | Get when subscription emails should be delivered: 0: Sunday, 1: Monday, etc. (Applies when subscription_delivery_email_default equals weekly.) |
| subscription_delivery_hour | (int) | Get at what hour of the day subscription emails should be delivered. Uses even numbers from 0 to 22, inclusive. (Applies when subscription_delivery_email_default equals daily or weekly.) |
| subscription_delivery_email_blocked | (bool) | Are all WordPress.com subscription emails blocked for the current user? |
| two_step_enabled | (bool) | Is two-step enabled for the current user? |
| two_step_sms_enabled | (bool) | Is the user using SMS as their second factor (instead of a code generating app)? |
| two_step_backup_codes_printed | (bool) | Has the current user printed their backup codes? |
| two_step_sms_country | (string) | Get the country for SMS backup for the current user (e.g. "US"). |
| two_step_sms_phone_number | (string) | Get the phone number for SMS backup for the current user (should not include + or country code). |
| two_step_app_enabled | (bool) | Is the user using an authenticator app as their second factor? |
| two_step_security_key_enabled | (bool) | Is the user using a security key (passkey) as a second factor? |
| two_step_enhanced_security | (bool) | Did the user opted in for enhanced two step account protection? |
| calypso_preferences | (object) | Get the preferences associated with a user's WordPress.com Calypso experience. |
| jetpack_connect | (array) | Get the urls of the jetpack sites the user have attempted to connect from Calypso |
| locale_variant | (string) | The locale variant locale code, if any. |
| tracks_opt_out | (bool) | Did the user opted out of Tracks? |
| i18n_empathy_mode | (bool) | Has the user enabled I18n empathy mode? |
| use_fallback_for_incomplete_languages | (bool) | Should UI be displayed in default locale for languages with incomplete translations |
| gravatar_profile_hidden | (bool) | Is the gravatar profile hidden for this user? |
| is_dev_account | (bool) | Is this a developer account? |
| last_admin_activity_timestamp | (string) | Get Unix timestamp the user was last seen in the admin. |
| advertising_targeting_opt_out | (bool) | Did the user opt out of advertising targeting? |
| p2_disable_autofollow_on_comment | (bool) | Don't automatically subscribe to notifications for a P2 post whenever you leave a comment on it. |
| mcp_abilities | (array) | List of MCP Abilities enabled. |
Resource Errors
This endpoint does not return any errors.
Example
curl \ -H 'authorization: Bearer YOUR_API_TOKEN' \ 'https://public-api.wordpress.com/rest/v1.1/me/settings/'
<?php
$options = array (
'http' =>
array (
'ignore_errors' => true,
'header' =>
array (
0 => 'authorization: Bearer YOUR_API_TOKEN',
),
),
);
$context = stream_context_create( $options );
$response = file_get_contents(
'https://public-api.wordpress.com/rest/v1.1/me/settings/',
false,
$context
);
$response = json_decode( $response );
?>
