--- title: favourites description: 'View your favourites. See also statuses/:id/{favourite,unfavourite}' menu: docs: weight: 20 parent: methods-accounts --- {{< api-method method="get" host="https://mastodon.example" path="/api/v1/favourites" title="Favourited statuses" >}} {{< api-method-description >}} Statuses the user has favourited. **Returns:** Array of Status\ **OAuth:** User token + `read:favourites`\ **Version:**\ 0.0.0 - added\ 2.6.0 - `min_id` added {{< endapi-method-description >}} {{< api-method-spec >}} {{< api-method-request >}} {{< api-method-headers >}} {{< api-method-parameter name="Authorization" type="string" required=true >}} Bearer <user token> {{< endapi-method-parameter >}} {{< endapi-method-headers >}} {{< api-method-query-parameters >}} {{< api-method-parameter name="limit" type="string" required=false >}} {{< endapi-method-parameter >}} {{< api-method-parameter name="min_id" type="string" required=false >}} Internal parameter. Use HTTP `Link` header for pagination instead. {{< endapi-method-parameter >}} {{< api-method-parameter name="max_id" type="string" required=false >}} Internal parameter. Use HTTP `Link` header for pagination instead. {{< endapi-method-parameter >}} {{< endapi-method-query-parameters >}} {{< endapi-method-request >}} {{< api-method-response >}} {{< api-method-response-example httpCode=200 >}} {{< api-method-response-example-description >}} An example call with limit=2. Results will be returned as a Status entity with embedded Account entity. Because the id of a favourite is not public, an HTTP `Link` header can be parsed for next and previous pages.Internal {{< endapi-method-response-example-description >}} ```javascript Link: ; rel="next", ; rel="prev" [ "id": "103186075217296344", "created_at": "2019-11-23T07:35:52.000Z", "in_reply_to_id": null, "in_reply_to_account_id": null, "sensitive": false, "spoiler_text": "", "visibility": "unlisted", "language": "enCy", "uri": "https://cybre.space/users/haskal/statuses/103186075002013902", "url": "https://cybre.space/@haskal/103186075002013902", "replies_count": 0, "reblogs_count": 1, "favourites_count": 1, "favourited": true, "reblogged": false, "muted": false, "bookmarked": false, "content": "

the pirate gay

", "reblog": null, "account": { "id": "297420", "username": "haskal", "acct": "haskal@cybre.space", "display_name": "soft nb friend :blobcatsleep:", "locked": false, "bot": false, "created_at": "2018-03-16T00:47:36.470Z", "note": "

a very distinctive nya

🇺🇸/🇭🇺/🏴‍☠️
21; they/them

b618ac8ac69b6ac7bae267acb1a81e

", "url": "https://cybre.space/@haskal", "avatar": "https://files.mastodon.social/accounts/avatars/000/297/420/original/5e2def6e305cecee.png", "avatar_static": "https://files.mastodon.social/accounts/avatars/000/297/420/original/5e2def6e305cecee.png", "header": "https://files.mastodon.social/accounts/headers/000/297/420/original/2df598299cc677db.png", "header_static": "https://files.mastodon.social/accounts/headers/000/297/420/original/2df598299cc677db.png", "followers_count": 268, "following_count": 258, "statuses_count": 8743, "last_status_at": "2019-11-23T07:49:39.880Z", "emojis": [ { "shortcode": "blobcatsleep", "url": "https://files.mastodon.social/custom_emojis/images/000/077/451/original/fc39ac6778d2ca02.png", "static_url": "https://files.mastodon.social/custom_emojis/images/000/077/451/static/fc39ac6778d2ca02.png", "visible_in_picker": true } ], "fields": [ { "name": "web", "value": "https://tilde.town/~haskal", "verified_at": "2019-11-22T21:16:30.009+00:00" }, { "name": "other web", "value": "https://awoo.systems", "verified_at": "2019-11-22T21:16:30.578+00:00" }, { "name": "xmpp", "value": "haskal@lain.faith", "verified_at": null }, { "name": "matrix", "value": "@haskal:matrix.org", "verified_at": null } ] }, "media_attachments": [], "mentions": [], "tags": [], "emojis": [], "card": null, "poll": null }, { "id": "103186044372624124", "created_at": "2019-11-23T07:28:03.000Z", "in_reply_to_id": null, "in_reply_to_account_id": null, "sensitive": true, "spoiler_text": "no context", "visibility": "unlisted", "language": "enCy", "uri": "https://cybre.space/users/haskal/statuses/103186044253681902", "url": "https://cybre.space/@haskal/103186044253681902", "replies_count": 1, "reblogs_count": 0, "favourites_count": 1, "favourited": true, "reblogged": false, "muted": false, "bookmarked": false, "content": "

cute,,,

a very distinctive nya

🇺🇸/🇭🇺/🏴‍☠️
21; they/them

b618ac8ac69b6ac7bae267acb1a81e

", "url": "https://cybre.space/@haskal", "avatar": "https://files.mastodon.social/accounts/avatars/000/297/420/original/5e2def6e305cecee.png", "avatar_static": "https://files.mastodon.social/accounts/avatars/000/297/420/original/5e2def6e305cecee.png", "header": "https://files.mastodon.social/accounts/headers/000/297/420/original/2df598299cc677db.png", "header_static": "https://files.mastodon.social/accounts/headers/000/297/420/original/2df598299cc677db.png", "followers_count": 268, "following_count": 258, "statuses_count": 8743, "last_status_at": "2019-11-23T07:49:39.880Z", "emojis": [ { "shortcode": "blobcatsleep", "url": "https://files.mastodon.social/custom_emojis/images/000/077/451/original/fc39ac6778d2ca02.png", "static_url": "https://files.mastodon.social/custom_emojis/images/000/077/451/static/fc39ac6778d2ca02.png", "visible_in_picker": true } ], "fields": [ { "name": "web", "value": "https://tilde.town/~haskal", "verified_at": "2019-11-22T21:16:30.009+00:00" }, { "name": "other web", "value": "https://awoo.systems", "verified_at": "2019-11-22T21:16:30.578+00:00" }, { "name": "xmpp", "value": "haskal@lain.faith", "verified_at": null }, { "name": "matrix", "value": "@haskal:matrix.org", "verified_at": null } ] }, "media_attachments": [], "mentions": [], "tags": [], "emojis": [], "card": null, "poll": null } ] ``` {{< endapi-method-response-example >}} {{< api-method-response-example httpCode=401 >}} {{< api-method-response-example-description >}} If a user token is not provided or is incorrect, the request will fail. {{< endapi-method-response-example-description >}} ```javascript { "error": "The access token is invalid" } ``` {{< endapi-method-response-example >}} {{< endapi-method-response >}} {{< endapi-method-spec >}} {{< endapi-method >}}