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)	display: (default) Formats the output as HTML for display. Shortcodes are parsed, paragraph tags are added, etc.. edit: Formats the output for editing. Shortcodes are left unparsed, significant whitespace is kept, etc..
http_envelope	(bool)	false: (default) true: Some environments (like in-browser JavaScript or Flash) block or divert responses with a non-200 HTTP status code. Setting this parameter will force the HTTP status code to always be 200. The JSON response is wrapped in an "envelope" containing the "real" HTTP status code and headers.
pretty	(bool)	false: (default) true: Output pretty JSON
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?

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 );
?>