GET
/2/profile/{handle}/statuses
Optional since (Unix time): when used without cursor, returns 204 No Content if no posts in the page are newer than that instant; otherwise returns the normal JSON timeline. Values ≥ 1e12 are treated as milliseconds; smaller values as seconds.
string
Username without @, or numeric user id as id:<rest_id> (e.g. id:783214). Case-insensitive id: prefix.
count
integer
default: 20 >= 1 <= 100
cursor
string
Pagination cursor from prior response
since
number
nullable
Unix timestamp (seconds, or ms if ≥ 1e12). Without cursor, 204 if no post is strictly newer than this time.
with_replies
string
If truthy (1, true, yes, on, or empty), include replies using alternate upstream timelines
lang
string
Example Target language (ISO 639-1 or 639-5, e.g. en, es, zh-cn) for inline X translations when available; falls back to translation API if missing
Select media type application/json object Array<object>
object created_timestamp required
object object Array<object>
object Facet kind: e.g. url, mention, hashtag, bold, media, custom_emoji (Mastodon custom emoji image)
string
Start and end UTF-16 indices
Array<number>
>= 2 items <= 2 items
verification
object string
nullable
Allowed values: organization government individual
object external
object string
Allowed values: video
photos
Array<object>
object string
Allowed values: photo gif
videos
Array<object>
object string
Allowed values: video gif
Array<object>
object container
string
Allowed values: mp4 webm m3u8
codec
string
Allowed values: h264 hevc vp9 av1
publisher
object object Array<object>
object Facet kind: e.g. url, mention, hashtag, bold, media, custom_emoji (Mastodon custom emoji image)
string
Start and end UTF-16 indices
Array<number>
>= 2 items <= 2 items
verification
object string
nullable
Allowed values: organization government individual
all
Array
Any of:
object string
Allowed values: photo gif
object string
Allowed values: video gif
Array<object>
object container
string
Allowed values: mp4 webm m3u8
codec
string
Allowed values: h264 hevc vp9 av1
publisher
object object Array<object>
object Facet kind: e.g. url, mention, hashtag, bold, media, custom_emoji (Mastodon custom emoji image)
string
Start and end UTF-16 indices
Array<number>
>= 2 items <= 2 items
verification
object string
nullable
Allowed values: organization government individual
object string
Allowed values: mosaic_photo
mosaic
object string
Allowed values: mosaic_photo
broadcast
object string
Allowed values: LIVE ENDED
string
Allowed values: landscape portrait
object display_text_range required
Array<number>
>= 2 items <= 2 items
Array<object>
object Facet kind: e.g. url, mention, hashtag, bold, media, custom_emoji (Mastodon custom emoji image)
string
Start and end UTF-16 indices
Array<number>
>= 2 items <= 2 items
possibly_sensitive required
string
Allowed values: tweet summary summary_large_image player
string
Allowed values: twitter
community
object admin
object object Array<object>
object Facet kind: e.g. url, mention, hashtag, bold, media, custom_emoji (Mastodon custom emoji image)
string
Start and end UTF-16 indices
Array<number>
>= 2 items <= 2 items
verification
object string
nullable
Allowed values: organization government individual
creator
object object Array<object>
object Facet kind: e.g. url, mention, hashtag, bold, media, custom_emoji (Mastodon custom emoji image)
string
Start and end UTF-16 indices
Array<number>
>= 2 items <= 2 items
verification
object string
nullable
Allowed values: organization government individual
string
Allowed values: Open Closed
string
Allowed values: MemberInvitesAllowed MemberInvitesDisabled
article
object object Any of:
object string
Allowed values: ApiImage
original_img_height required
original_img_width required
original_img_url required
object Any of:
string
Allowed values: ApiVideo
string
Allowed values: ApiGif
Any of:
string
Allowed values: video
string
Allowed values: animated_gif
object object string
Allowed values: fit
object Array<number>
>= 2 items <= 2 items
object blocks
Array<object>
default:
object object key additional properties
inlineStyleRanges required
entityMap
Array
default:
Any of:
object object string
Allowed values: MARKDOWN
string
Allowed values: Mutable
object object string
Allowed values: MEDIA
string
Allowed values: Immutable
object object string
Allowed values: TWEET
string
Allowed values: Immutable
Array<object>
object Any of:
object string
Allowed values: ApiImage
original_img_height required
original_img_width required
original_img_url required
object Any of:
string
Allowed values: ApiVideo
string
Allowed values: ApiGif
Any of:
string
Allowed values: video
string
Allowed values: animated_gif
object object string
Allowed values: fit
object Array<number>
>= 2 items <= 2 items
object Array<object>
object Facet kind: e.g. url, mention, hashtag, bold, media, custom_emoji (Mastodon custom emoji image)
string
Start and end UTF-16 indices
Array<number>
>= 2 items <= 2 items
No posts newer than since (only when since is set and cursor is omitted; same conditions as 200 otherwise)
Invalid path or query parameters (e.g. count out of range)
Select media type application/json object number
Allowed values: 400
User not found or empty timeline
Select media type application/json object Array<object>
object created_timestamp required
object object Array<object>
object Facet kind: e.g. url, mention, hashtag, bold, media, custom_emoji (Mastodon custom emoji image)
string
Start and end UTF-16 indices
Array<number>
>= 2 items <= 2 items
verification
object string
nullable
Allowed values: organization government individual
object external
object string
Allowed values: video
photos
Array<object>
object string
Allowed values: photo gif
videos
Array<object>
object string
Allowed values: video gif
Array<object>
object container
string
Allowed values: mp4 webm m3u8
codec
string
Allowed values: h264 hevc vp9 av1
publisher
object object Array<object>
object Facet kind: e.g. url, mention, hashtag, bold, media, custom_emoji (Mastodon custom emoji image)
string
Start and end UTF-16 indices
Array<number>
>= 2 items <= 2 items
verification
object string
nullable
Allowed values: organization government individual
all
Array
Any of:
object string
Allowed values: photo gif
object string
Allowed values: video gif
Array<object>
object container
string
Allowed values: mp4 webm m3u8
codec
string
Allowed values: h264 hevc vp9 av1
publisher
object object Array<object>
object Facet kind: e.g. url, mention, hashtag, bold, media, custom_emoji (Mastodon custom emoji image)
string
Start and end UTF-16 indices
Array<number>
>= 2 items <= 2 items
verification
object string
nullable
Allowed values: organization government individual
object string
Allowed values: mosaic_photo
mosaic
object string
Allowed values: mosaic_photo
broadcast
object string
Allowed values: LIVE ENDED
string
Allowed values: landscape portrait
object display_text_range required
Array<number>
>= 2 items <= 2 items
Array<object>
object Facet kind: e.g. url, mention, hashtag, bold, media, custom_emoji (Mastodon custom emoji image)
string
Start and end UTF-16 indices
Array<number>
>= 2 items <= 2 items
possibly_sensitive required
string
Allowed values: tweet summary summary_large_image player
string
Allowed values: twitter
community
object admin
object object Array<object>
object Facet kind: e.g. url, mention, hashtag, bold, media, custom_emoji (Mastodon custom emoji image)
string
Start and end UTF-16 indices
Array<number>
>= 2 items <= 2 items
verification
object string
nullable
Allowed values: organization government individual
creator
object object Array<object>
object Facet kind: e.g. url, mention, hashtag, bold, media, custom_emoji (Mastodon custom emoji image)
string
Start and end UTF-16 indices
Array<number>
>= 2 items <= 2 items
verification
object string
nullable
Allowed values: organization government individual
string
Allowed values: Open Closed
string
Allowed values: MemberInvitesAllowed MemberInvitesDisabled
article
object object Any of:
object string
Allowed values: ApiImage
original_img_height required
original_img_width required
original_img_url required
object Any of:
string
Allowed values: ApiVideo
string
Allowed values: ApiGif
Any of:
string
Allowed values: video
string
Allowed values: animated_gif
object object string
Allowed values: fit
object Array<number>
>= 2 items <= 2 items
object blocks
Array<object>
default:
object object key additional properties
inlineStyleRanges required
entityMap
Array
default:
Any of:
object object string
Allowed values: MARKDOWN
string
Allowed values: Mutable
object object string
Allowed values: MEDIA
string
Allowed values: Immutable
object object string
Allowed values: TWEET
string
Allowed values: Immutable
Array<object>
object Any of:
object string
Allowed values: ApiImage
original_img_height required
original_img_width required
original_img_url required
object Any of:
string
Allowed values: ApiVideo
string
Allowed values: ApiGif
Any of:
string
Allowed values: video
string
Allowed values: animated_gif
object object string
Allowed values: fit
object Array<number>
>= 2 items <= 2 items
object Array<object>
object Facet kind: e.g. url, mention, hashtag, bold, media, custom_emoji (Mastodon custom emoji image)
string
Start and end UTF-16 indices
Array<number>
>= 2 items <= 2 items
Upstream or processing error
Select media type application/json object Array<object>
object created_timestamp required
object object Array<object>
object Facet kind: e.g. url, mention, hashtag, bold, media, custom_emoji (Mastodon custom emoji image)
string
Start and end UTF-16 indices
Array<number>
>= 2 items <= 2 items
verification
object string
nullable
Allowed values: organization government individual
object external
object string
Allowed values: video
photos
Array<object>
object string
Allowed values: photo gif
videos
Array<object>
object string
Allowed values: video gif
Array<object>
object container
string
Allowed values: mp4 webm m3u8
codec
string
Allowed values: h264 hevc vp9 av1
publisher
object object Array<object>
object Facet kind: e.g. url, mention, hashtag, bold, media, custom_emoji (Mastodon custom emoji image)
string
Start and end UTF-16 indices
Array<number>
>= 2 items <= 2 items
verification
object string
nullable
Allowed values: organization government individual
all
Array
Any of:
object string
Allowed values: photo gif
object string
Allowed values: video gif
Array<object>
object container
string
Allowed values: mp4 webm m3u8
codec
string
Allowed values: h264 hevc vp9 av1
publisher
object object Array<object>
object Facet kind: e.g. url, mention, hashtag, bold, media, custom_emoji (Mastodon custom emoji image)
string
Start and end UTF-16 indices
Array<number>
>= 2 items <= 2 items
verification
object string
nullable
Allowed values: organization government individual
object string
Allowed values: mosaic_photo
mosaic
object string
Allowed values: mosaic_photo
broadcast
object string
Allowed values: LIVE ENDED
string
Allowed values: landscape portrait
object display_text_range required
Array<number>
>= 2 items <= 2 items
Array<object>
object Facet kind: e.g. url, mention, hashtag, bold, media, custom_emoji (Mastodon custom emoji image)
string
Start and end UTF-16 indices
Array<number>
>= 2 items <= 2 items
possibly_sensitive required
string
Allowed values: tweet summary summary_large_image player
string
Allowed values: twitter
community
object admin
object object Array<object>
object Facet kind: e.g. url, mention, hashtag, bold, media, custom_emoji (Mastodon custom emoji image)
string
Start and end UTF-16 indices
Array<number>
>= 2 items <= 2 items
verification
object string
nullable
Allowed values: organization government individual
creator
object object Array<object>
object Facet kind: e.g. url, mention, hashtag, bold, media, custom_emoji (Mastodon custom emoji image)
string
Start and end UTF-16 indices
Array<number>
>= 2 items <= 2 items
verification
object string
nullable
Allowed values: organization government individual
string
Allowed values: Open Closed
string
Allowed values: MemberInvitesAllowed MemberInvitesDisabled
article
object object Any of:
object string
Allowed values: ApiImage
original_img_height required
original_img_width required
original_img_url required
object Any of:
string
Allowed values: ApiVideo
string
Allowed values: ApiGif
Any of:
string
Allowed values: video
string
Allowed values: animated_gif
object object string
Allowed values: fit
object Array<number>
>= 2 items <= 2 items
object blocks
Array<object>
default:
object object key additional properties
inlineStyleRanges required
entityMap
Array
default:
Any of:
object object string
Allowed values: MARKDOWN
string
Allowed values: Mutable
object object string
Allowed values: MEDIA
string
Allowed values: Immutable
object object string
Allowed values: TWEET
string
Allowed values: Immutable
Array<object>
object Any of:
object string
Allowed values: ApiImage
original_img_height required
original_img_width required
original_img_url required
object Any of:
string
Allowed values: ApiVideo
string
Allowed values: ApiGif
Any of:
string
Allowed values: video
string
Allowed values: animated_gif
object object string
Allowed values: fit
object Array<number>
>= 2 items <= 2 items
object Array<object>
object Facet kind: e.g. url, mention, hashtag, bold, media, custom_emoji (Mastodon custom emoji image)
string
Start and end UTF-16 indices
Array<number>
>= 2 items <= 2 items