2020-01-01 22:37:59 +01:00
---
title: Status
description: Represents a status posted by an account.
menu:
docs:
parent: entities
2022-11-20 07:34:38 +01:00
aliases: [
"/entities/mention",
"/entities/Mention",
"/entities/status",
"/entities/Status",
"/api/entities/mention",
"/api/entities/Mention",
"/api/entities/status",
"/api/entities/Status",
]
2020-01-01 22:37:59 +01:00
---
## Example
2022-11-20 07:34:38 +01:00
```json
2020-01-01 22:37:59 +01:00
{
"id": "103270115826048975",
"created_at": "2019-12-08T03:48:33.901Z",
"in_reply_to_id": null,
"in_reply_to_account_id": null,
"sensitive": false,
"spoiler_text": "",
"visibility": "public",
"language": "en",
"uri": "https://mastodon.social/users/Gargron/statuses/103270115826048975",
"url": "https://mastodon.social/@Gargron/103270115826048975",
"replies_count": 5,
"reblogs_count": 6,
"favourites_count": 11,
"favourited": false,
"reblogged": false,
"muted": false,
"bookmarked": false,
2020-01-12 14:11:56 +01:00
"content": "< p > " I lost my inheritance with one wrong digit on my sort code" </ p >< p >< a href = \"https://www.theguardian.com/money/2019/dec/07/i-lost-my-193000-inheritance-with-one-wrong-digit-on-my-sort-code \" rel = \"nofollow noopener noreferrer \" target = \"_blank \">< span class = \"invisible \"> https://www.</ span >< span class = \"ellipsis \"> theguardian.com/money/2019/dec</ span >< span class = \"invisible \"> /07/i-lost-my-193000-inheritance-with-one-wrong-digit-on-my-sort-code< /span}</ p > ",
2020-01-01 22:37:59 +01:00
"reblog": null,
"application": {
"name": "Web",
"website": null
},
"account": {
"id": "1",
"username": "Gargron",
"acct": "Gargron",
"display_name": "Eugen",
"locked": false,
"bot": false,
"discoverable": true,
"group": false,
"created_at": "2016-03-16T14:34:26.392Z",
"note": "< p > Developer of Mastodon and administrator of mastodon.social. I post service announcements, development updates, and personal stuff.< / p > ",
"url": "https://mastodon.social/@Gargron",
"avatar": "https://files.mastodon.social/accounts/avatars/000/000/001/original/d96d39a0abb45b92.jpg",
"avatar_static": "https://files.mastodon.social/accounts/avatars/000/000/001/original/d96d39a0abb45b92.jpg",
"header": "https://files.mastodon.social/accounts/headers/000/000/001/original/c91b871f294ea63e.png",
"header_static": "https://files.mastodon.social/accounts/headers/000/000/001/original/c91b871f294ea63e.png",
"followers_count": 322930,
"following_count": 459,
"statuses_count": 61323,
"last_status_at": "2019-12-10T08:14:44.811Z",
"emojis": [],
"fields": [
{
"name": "Patreon",
2020-01-12 14:11:56 +01:00
"value": "< a href = \"https://www.patreon.com/mastodon \" rel = \"me nofollow noopener noreferrer \" target = \"_blank \">< span class = \"invisible \"> https://www.</ span >< span class = \"\"> patreon.com/mastodon</span >< span class = \"invisible \"> < /span}",
2020-01-01 22:37:59 +01:00
"verified_at": null
},
{
"name": "Homepage",
2020-01-12 14:11:56 +01:00
"value": "< a href = \"https://zeonfederated.com \" rel = \"me nofollow noopener noreferrer \" target = \"_blank \">< span class = \"invisible \"> https://</ span >< span class = \"\"> zeonfederated.com</span >< span class = \"invisible \"> < /span}",
2020-01-01 22:37:59 +01:00
"verified_at": "2019-07-15T18:29:57.191+00:00"
}
]
},
"media_attachments": [],
"mentions": [],
"tags": [],
"emojis": [],
"card": {
"url": "https://www.theguardian.com/money/2019/dec/07/i-lost-my-193000-inheritance-with-one-wrong-digit-on-my-sort-code",
"title": "‘ I lost my £193,000 inheritance – with one wrong digit on my sort code’ ",
"description": "When Peter Teich’ s money went to another Barclays customer, the bank offered £25 as a token gesture",
"type": "link",
"author_name": "",
"author_url": "",
"provider_name": "",
"provider_url": "",
"html": "",
"width": 0,
"height": 0,
"image": null,
"embed_url": ""
},
"poll": null
}
```
2022-11-20 07:34:38 +01:00
## Attributes
2020-01-01 22:37:59 +01:00
2020-01-12 14:11:56 +01:00
### `id` {#id}
2020-01-01 22:37:59 +01:00
2020-01-12 14:11:56 +01:00
**Description:** ID of the status in the database.\
2022-11-20 07:34:38 +01:00
**Type:** String (cast from an integer but not guaranteed to be a number)\
**Version history:**\
0.1.0 - added
2020-01-01 22:37:59 +01:00
2020-01-12 14:11:56 +01:00
### `uri` {#uri}
2020-01-01 22:37:59 +01:00
2020-01-12 14:11:56 +01:00
**Description:** URI of the status used for federation.\
**Type:** String\
2022-11-20 07:34:38 +01:00
**Version history:**\
0.1.0 - added
2020-01-01 22:37:59 +01:00
2020-01-12 14:11:56 +01:00
### `created_at` {#created_at}
2020-01-01 22:37:59 +01:00
2020-02-20 17:55:04 +01:00
**Description:** The date when this status was created.\
2022-11-20 07:34:38 +01:00
**Type:** String (ISO 8601 Datetime)\
**Version history:**\
0.1.0 - added
2020-01-01 22:37:59 +01:00
2020-01-12 14:11:56 +01:00
### `account` {#account}
2020-01-01 22:37:59 +01:00
2020-01-12 14:11:56 +01:00
**Description:** The account that authored this status.\
2022-11-20 07:34:38 +01:00
**Type:** [Account ]({{< relref "entities/Account" >}} )\
**Version history:**\
0.1.0 - added
2020-01-01 22:37:59 +01:00
2020-01-12 14:11:56 +01:00
### `content` {#content}
2020-01-01 22:37:59 +01:00
2020-01-12 14:11:56 +01:00
**Description:** HTML-encoded status content.\
2022-11-20 07:34:38 +01:00
**Type:** String (HTML)\
**Version history:**\
0.1.0 - added
2020-01-01 22:37:59 +01:00
2020-01-12 14:11:56 +01:00
### `visibility` {#visibility}
2020-01-01 22:37:59 +01:00
2020-02-20 17:55:04 +01:00
**Description:** Visibility of this status.\
2022-11-20 07:34:38 +01:00
**Type:** String (Enumerable oneOf)\
2020-01-12 14:11:56 +01:00
`public` = Visible to everyone, shown in public timelines.\
`unlisted` = Visible to public, but not included in public timelines.\
`private` = Visible to followers only, and to any mentioned users.\
`direct` = Visible only to mentioned users.\
2022-11-20 07:34:38 +01:00
**Version history:**\
0.9.9 - added
2020-01-01 22:37:59 +01:00
2020-01-12 14:11:56 +01:00
### `sensitive` {#sensitive}
2020-01-01 22:37:59 +01:00
2020-01-12 14:11:56 +01:00
**Description:** Is this status marked as sensitive content?\
**Type:** Boolean\
2022-11-20 07:34:38 +01:00
**Version history:**\
0.9.9 - added
2020-01-01 22:37:59 +01:00
2020-01-12 14:11:56 +01:00
### `spoiler_text` {#spoiler_text}
2020-01-01 22:37:59 +01:00
2020-01-12 14:11:56 +01:00
**Description:** Subject or summary line, below which status content is collapsed until expanded.\
**Type:** String\
2022-11-20 07:34:38 +01:00
**Version history:**\
1.0.0 - added
2020-01-01 22:37:59 +01:00
2020-01-12 14:11:56 +01:00
### `media_attachments` {#media_attachments}
2020-01-01 22:37:59 +01:00
2020-01-12 14:11:56 +01:00
**Description:** Media that is attached to this status.\
2022-11-20 07:34:38 +01:00
**Type:** Array of [MediaAttachment ]({{< relref "entities/MediaAttachment" >}} )\
**Version history:**\
0.6.0 - added
2020-01-01 22:37:59 +01:00
2022-11-20 07:34:38 +01:00
### `application` {{%optional%}} {#application}
2020-01-01 22:37:59 +01:00
2020-01-12 14:11:56 +01:00
**Description:** The application used to post this status.\
2022-11-20 07:34:38 +01:00
**Type:** Hash\
**Version history:**\
0.9.9 - added
2020-01-01 22:37:59 +01:00
2022-11-20 07:34:38 +01:00
#### `application[name]` {#application-name}
**Description:** The name of the application that posted this status.\
**Type:** String\
**Version history:**\
0.9.9 - added
#### `application[website]` {#application-website}
**Description:** The website associated with the application that posted this status.\
**Type:** {{< nullable > }} String (URL) or null\
**Version history:**\
2022-12-14 22:55:30 +01:00
0.9.9 - added\
2022-11-20 07:34:38 +01:00
3.5.1 - this property is now nullable
2020-01-01 22:37:59 +01:00
2020-01-12 14:11:56 +01:00
### `mentions` {#mentions}
2020-01-01 22:37:59 +01:00
2020-01-12 14:11:56 +01:00
**Description:** Mentions of users within the status content.\
2022-11-20 07:34:38 +01:00
**Type:** Array of [Status::Mention ](#Mention )\
**Version history:**\
0.6.0 - added
2020-01-01 22:37:59 +01:00
2020-01-12 14:11:56 +01:00
### `tags` {#tags}
2020-01-01 22:37:59 +01:00
2020-01-12 14:11:56 +01:00
**Description:** Hashtags used within the status content.\
2022-11-20 07:34:38 +01:00
**Type:** Array of [Status::Tag ](#Tag )\
**Version history:**\
0.6.0 - added
2020-01-01 22:37:59 +01:00
2020-01-12 14:11:56 +01:00
### `emojis` {#emojis}
2020-01-01 22:37:59 +01:00
2020-01-12 14:11:56 +01:00
**Description:** Custom emoji to be used when rendering status content.\
2022-11-20 07:34:38 +01:00
**Type:** Array of [CustomEmoji ]({{< relref "entities/CustomEmoji" >}} )\
**Version history:**\
2.0.0 - added
2020-01-01 22:37:59 +01:00
2020-01-12 14:11:56 +01:00
### `reblogs_count` {#reblogs_count}
2020-01-01 22:37:59 +01:00
2020-01-12 14:11:56 +01:00
**Description:** How many boosts this status has received.\
2022-11-20 07:34:38 +01:00
**Type:** Integer\
**Version history:**\
0.1.0 - added
2020-01-01 22:37:59 +01:00
2020-01-12 14:11:56 +01:00
### `favourites_count` {#favorites_count}
2020-01-01 22:37:59 +01:00
2020-01-12 14:11:56 +01:00
**Description:** How many favourites this status has received.\
2022-11-20 07:34:38 +01:00
**Type:** Integer\
**Version history:**\
0.1.0 - added
2020-01-01 22:37:59 +01:00
2020-01-12 14:11:56 +01:00
### `replies_count` {#replies_count}
2020-01-01 22:37:59 +01:00
2020-01-12 14:11:56 +01:00
**Description:** How many replies this status has received.\
2022-11-20 07:34:38 +01:00
**Type:** Integer\
**Version history:**\
2.5.0 - added
2020-01-01 22:37:59 +01:00
2020-01-12 14:11:56 +01:00
### `url` {#url}
2020-01-01 22:37:59 +01:00
2020-01-12 14:11:56 +01:00
**Description:** A link to the status's HTML representation.\
2022-11-20 07:34:38 +01:00
**Type:** {{< nullable > }} String (URL) or null\
**Version history:**\
0.1.0 - added
2020-01-01 22:37:59 +01:00
2020-01-12 14:11:56 +01:00
### `in_reply_to_id` {#in_reply_to_id}
2020-01-01 22:37:59 +01:00
2022-11-20 07:34:38 +01:00
**Description:** ID of the status being replied to.\
**Type:** {{< nullable > }} String (cast from an integer but not guaranteed to be a number) or null\
**Version history:**\
0.1.0 - added
2020-01-01 22:37:59 +01:00
2020-01-12 14:11:56 +01:00
### `in_reply_to_account_id` {#in_reply_to_account_id}
2020-01-01 22:37:59 +01:00
2022-11-20 07:34:38 +01:00
**Description:** ID of the account that authored the status being replied to.\
**Type:** {{< nullable > }} String (cast from an integer but not guaranteed to be a number) or null\
**Version history:**\
0.1.0 - added
2020-01-01 22:37:59 +01:00
2020-01-12 14:11:56 +01:00
### `reblog` {#reblog}
2020-01-01 22:37:59 +01:00
2020-02-20 17:55:04 +01:00
**Description:** The status being reblogged.\
2022-11-20 07:34:38 +01:00
**Type:** {{< nullable > }} [Status ](# ) or null\
**Version history:**\
0.1.0 - added
2020-01-01 22:37:59 +01:00
2020-01-12 14:11:56 +01:00
### `poll` {#poll}
2020-01-01 22:37:59 +01:00
2020-01-12 14:11:56 +01:00
**Description:** The poll attached to the status.\
2022-11-20 07:34:38 +01:00
**Type:** {{< nullable > }} [Poll ]({{< relref "entities/Poll" >}} ) or null\
**Version history:**\
2.8.0 - added
2020-01-01 22:37:59 +01:00
2020-01-12 14:11:56 +01:00
### `card` {#card}
2020-01-01 22:37:59 +01:00
2020-01-12 14:11:56 +01:00
**Description:** Preview card for links included within status content.\
2022-11-20 07:34:38 +01:00
**Type:** {{< nullable > }} [PreviewCard ]({{< relref "entities/PreviewCard" >}} ) or null\
**Version history:**\
2.6.0 - added
2020-01-01 22:37:59 +01:00
2020-01-12 14:11:56 +01:00
### `language` {#language}
2020-01-01 22:37:59 +01:00
2020-02-20 17:55:04 +01:00
**Description:** Primary language of this status.\
2022-11-20 07:34:38 +01:00
**Type:** {{< nullable > }} String (ISO 639 Part 1 two-letter language code) or null\
**Version history:**\
1.4.0 - added
2020-01-01 22:37:59 +01:00
2020-02-20 17:55:04 +01:00
### `text` {#text}
**Description:** Plain-text source of a status. Returned instead of `content` when status is deleted, so the user may redraft from the source text without the client having to reverse-engineer the original text from the HTML content.\
2022-11-20 07:34:38 +01:00
**Type:** {{< nullable > }} String or null\
**Version history:**\
2.9.0 - added
2020-02-20 17:55:04 +01:00
2022-11-20 07:34:38 +01:00
### `edited_at` {#edited_at}
2020-01-01 22:37:59 +01:00
2022-11-20 07:34:38 +01:00
**Description:** Timestamp of when the status was last edited.\
**Type:** {{< nullable > }} String (ISO 8601 Datetime)\
**Version history:**\
3.5.0 - added
2020-01-01 22:37:59 +01:00
2022-11-20 07:34:38 +01:00
### `favourited` {{%optional%}} {#favourited}
**Description:** If the current token has an authorized user: Have you favourited this status?\
2020-01-12 14:11:56 +01:00
**Type:** Boolean\
2022-11-20 07:34:38 +01:00
**Version history:**\
0.1.0 - added
2020-01-01 22:37:59 +01:00
2022-11-20 07:34:38 +01:00
### `reblogged` {{%optional%}} {#reblogged}
2020-01-01 22:37:59 +01:00
2022-11-20 07:34:38 +01:00
**Description:** If the current token has an authorized user: Have you boosted this status?\
2020-01-12 14:11:56 +01:00
**Type:** Boolean\
2022-11-20 07:34:38 +01:00
**Version history:**\
0.1.0 - added
2020-01-01 22:37:59 +01:00
2022-11-20 07:34:38 +01:00
### `muted` {{%optional%}} {#muted}
2020-01-01 22:37:59 +01:00
2022-11-20 07:34:38 +01:00
**Description:** If the current token has an authorized user: Have you muted notifications for this status's conversation?\
2020-01-12 14:11:56 +01:00
**Type:** Boolean\
2022-11-20 07:34:38 +01:00
**Version history:**\
1.4.0 - added
2020-01-01 22:37:59 +01:00
2022-11-20 07:34:38 +01:00
### `bookmarked` {{%optional%}} {#bookmarked}
2020-01-01 22:37:59 +01:00
2022-11-20 07:34:38 +01:00
**Description:** If the current token has an authorized user: Have you bookmarked this status?\
2020-01-12 14:11:56 +01:00
**Type:** Boolean\
2022-11-20 07:34:38 +01:00
**Version history:**\
3.1.0 - added
2020-01-01 22:37:59 +01:00
2022-11-20 07:34:38 +01:00
### `pinned` {{%optional%}} {#pinned}
2020-01-01 22:37:59 +01:00
2022-11-20 07:34:38 +01:00
**Description:** If the current token has an authorized user: Have you pinned this status? Only appears if the status is pinnable.\
2020-01-12 14:11:56 +01:00
**Type:** Boolean\
2022-11-20 07:34:38 +01:00
**Version history:**\
1.6.0 - added
2020-01-01 22:37:59 +01:00
2022-11-20 07:34:38 +01:00
### `filtered` {{%optional%}} {#filtered}
**Description:** If the current token has an authorized user: The filter and keywords that matched this status.\
**Type:** Array of [FilterResult ]({{ relref "entities/FilterResult" }} )\
**Version history:**\
4.0.0 - added
## Status::Mention attributes {#Mention}
2020-01-01 22:37:59 +01:00
2022-11-20 07:34:38 +01:00
### `id` {#Mention-id}
2020-01-01 22:37:59 +01:00
2022-11-20 07:34:38 +01:00
**Description:** The account ID of the mentioned user.\
**Type:** String (cast from an integer, but not guaranteed to be a number)\
**Version history:**\
0.6.0 - added
### `username` {#Mention-username}
**Description:** The username of the mentioned user.\
**Type:** String\
**Version history:**\
0.6.0 - added
### `url` {#Mention-url}
**Description:** The location of the mentioned user's profile.\
**Type:** String (URL)\
**Version history:**\
0.6.0 - added
### `acct` {#Mention-acct}
**Description:** The webfinger acct: URI of the mentioned user. Equivalent to `username` for local users, or `username@domain` for remote users.\
**Type:** String\
**Version history:**\
0.6.0 - added
## Status::Tag attributes {#Tag}
### `name` {#Tag-name}
**Description:** The value of the hashtag after the # sign.\
**Type:** String\
**Version history:**\
0.9.0 - added
### `url` {#Tag-url}
**Description:** A link to the hashtag on the instance.\
**Type:** String (URL)\
**Version history:**\
0.9.0 - added
## See also
2020-01-01 22:37:59 +01:00
2022-11-20 07:34:38 +01:00
{{< page-relref ref = "methods/accounts#statuses" caption = "GET /api/v1/accounts/:id/statuses" > }}
2020-01-01 22:37:59 +01:00
2022-11-20 07:34:38 +01:00
{{< page-relref ref = "methods/search#v2" caption = "POST /api/v2/search/" > }}
2020-01-01 22:37:59 +01:00
2022-11-20 07:34:38 +01:00
{{< page-relref ref = "methods/statuses" caption = "statuses methods" > }}
2020-01-01 22:37:59 +01:00
2022-11-20 07:34:38 +01:00
{{< caption-link url = "https://github.com/mastodon/mastodon/blob/main/app/serializers/rest/status_serializer.rb" caption = "app/serializers/rest/status_serializer.rb" > }}