Get user profile
GET /2/profile/{handle}
GET
/2/profile/{handle}
Returns profile fields for a user. Optional about_account / aboutAccount (truthy) adds about_account on the user when available.
Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ” handle
required
string
Example
XUsername without @, or numeric user id as id:<rest_id> (e.g. id:783214). Case-insensitive id: prefix.
Query Parameters
Section titled “Query Parameters ” about_account
string
Example
1If truthy, include about_account on author when available
aboutAccount
string
Alias for about_account
Responses
Section titled “ Responses ”Profile (check code)
object
code
required
number
message
required
string
user
object
id
required
string
name
required
string
screen_name
required
string
avatar_url
required
string
banner_url
required
string
description
required
string
raw_description
required
object
text
required
string
facets
required
Array<object>
object
type
required
Facet kind: e.g. url, mention, hashtag, bold, media, custom_emoji (Mastodon custom emoji image)
string
indices
required
Start and end UTF-16 indices
Array<number>
original
string
replacement
string
display
string
id
string
location
required
string
url
required
string
protected
required
boolean
followers
required
number
following
required
number
statuses
required
number
media_count
required
number
likes
required
number
joined
required
string
website
required
object
url
required
string
display_url
required
string
birthday
object
day
number
month
number
year
number
verification
object
verified
required
boolean
type
required
string
verified_at
string
identity_verified
boolean
about_account
object
based_in
string
location_accurate
boolean
created_country_accurate
boolean
source
string
username_changes
object
count
required
number
last_changed_at
required
string
profile_embed
boolean
Invalid path or query parameters
object
code
required
number
message
required
string
User not found
object
code
required
number
message
required
string
user
object
id
required
string
name
required
string
screen_name
required
string
avatar_url
required
string
banner_url
required
string
description
required
string
raw_description
required
object
text
required
string
facets
required
Array<object>
object
type
required
Facet kind: e.g. url, mention, hashtag, bold, media, custom_emoji (Mastodon custom emoji image)
string
indices
required
Start and end UTF-16 indices
Array<number>
original
string
replacement
string
display
string
id
string
location
required
string
url
required
string
protected
required
boolean
followers
required
number
following
required
number
statuses
required
number
media_count
required
number
likes
required
number
joined
required
string
website
required
object
url
required
string
display_url
required
string
birthday
object
day
number
month
number
year
number
verification
object
verified
required
boolean
type
required
string
verified_at
string
identity_verified
boolean
about_account
object
based_in
string
location_accurate
boolean
created_country_accurate
boolean
source
string
username_changes
object
count
required
number
last_changed_at
required
string
profile_embed
boolean