Skip to content

Get user profile

GET
/2/profile/{handle}

Returns profile fields for a user. Optional about_account / aboutAccount (truthy) adds about_account on the user when available.

handle
required
string
Example
X

Username without @, or numeric user id as id:<rest_id> (e.g. id:783214). Case-insensitive id: prefix.

about_account
string
Example
1

If truthy, include about_account on author when available

aboutAccount
string

Alias for about_account

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
nullable
banner_url
required
string
nullable
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>
>= 2 items <= 2 items
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
nullable
Allowed values: organization government individual
verified_at
string
nullable
identity_verified
boolean
about_account
object
based_in
string
nullable
location_accurate
boolean
created_country_accurate
boolean
nullable
source
string
nullable
username_changes
object
count
required
number
last_changed_at
required
string
nullable
profile_embed
boolean

Invalid path or query parameters

object
code
required
number
Allowed values: 400
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
nullable
banner_url
required
string
nullable
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>
>= 2 items <= 2 items
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
nullable
Allowed values: organization government individual
verified_at
string
nullable
identity_verified
boolean
about_account
object
based_in
string
nullable
location_accurate
boolean
created_country_accurate
boolean
nullable
source
string
nullable
username_changes
object
count
required
number
last_changed_at
required
string
nullable
profile_embed
boolean