Mastodon API Specification (https://github.com/mastodon/mastodon)

get_api_oembed

OEmbed as JSON

get_api_proofs

View identity proof

get_api_v1_accounts_id

get_api_v1_accounts_id_featured_tags

Tags featured by this account.

get_api_v1_accounts_id_followers

Accounts which follow the given account, if network is not hidden by the account owner.

get_api_v1_accounts_id_following

Accounts which the given account is following, if network is not hidden by the account owner.

get_api_v1_accounts_id_identity_proofs

Array of IdentityProof

get_api_v1_accounts_id_lists

User lists that you have added this account to.

get_api_v1_accounts_id_statuses

Statuses posted to the given account.

get_api_v1_accounts_relationships

Sets a private note on a user.

get_api_v1_accounts_search

Search for matching accounts by username or display name.

get_api_v1_accounts_verify_credentials

Test to make sure that the user token works.

get_api_v1_admin_accounts_id

View admin-level information about the given account.

get_api_v1_admin_reports

View all reports. Pagination may be done with HTTP Link header in the response.

get_api_v1_admin_reports_id

View information about the report with the given ID.

get_api_v1_announcements

See all currently active announcements set by admins.

get_api_v1_apps_verify_credentials

Confirm that the app's OAuth2 credentials work.

get_api_v1_blocks

Get blocked users.

get_api_v1_bookmarks

Statuses the user has bookmarked.

get_api_v1_conversations

Show conversation.

get_api_v1_custom_emojis

Returns custom emojis that are available on the server.

get_api_v1_directory

List accounts visible in the directory.

get_api_v1_domain_blocks

View domains the user has blocked.

get_api_v1_endorsements

Accounts that the user is currently featuring on their profile.

get_api_v1_favourites

Statuses the user has favourited.

get_api_v1_featured_tags

View your featured tags.

get_api_v1_featured_tags_suggestions

Shows your 10 most-used tags, with usage history for the past week.

get_api_v1_filters

get_api_v1_filters_id

Get one filter.

get_api_v1_follow_requests

Pending Follows

get_api_v1_instance

Information about the server.

get_api_v1_instance_activity

Instance activity over the last 3 months, binned weekly.

get_api_v1_instance_peers

Information about the server.

get_api_v1_lists

Fetch all lists that the user owns.

get_api_v1_lists_id

Remove converstation

get_api_v1_lists_id_accounts

View accounts in List

get_api_v1_markers

Get saved timeline position

get_api_v1_media_id

Get an attachement.

get_api_v1_mutes

Accounts the user has muted.

get_api_v1_notifications

Notifications concerning the user. This API returns Link headers containing links to the next/previous page. However, the links can also be constructed dynamically using query params and id values.

get_api_v1_notifications_id

View information about a notification with a given ID.

get_api_v1_polls_id

View a poll.

get_api_v1_preferences

Shows your 10 most-used tags, with usage history for the past week.

get_api_v1_push_subscription

View the PushSubscription currently associated with this access token.

get_api_v1_scheduled_statuses

View scheduled statuses

get_api_v1_scheduled_statuses_id

View a single scheduled status

get_api_v1_statuses_id

get_api_v1_statuses_id_context

get_api_v1_statuses_id_favourited_by

View who favourited a given status.

get_api_v1_statuses_id_reblogged_by

View who boosted a given status.

get_api_v1_suggestions

Accounts the user has had past positive interactions with, but is not yet following.

get_api_v1_timelines_home

View statuses from followed users.

get_api_v1_timelines_list_list_id

View statuses in the given list timeline.

get_api_v1_timelines_public

Public timeline

get_api_v1_timelines_tag_hashtag

View public statuses containing the given hashtag.

get_api_v1_trends

Tags that are being used more frequently within the past week.

get_api_v2_search

Search results

post_api_v1_accounts

Creates a user and account records. Returns an account access token for the app that initiated the request. The app should save this token for later, and should wait for the user to confirm their account by clicking a link in their email inbox.

post_api_v1_accounts_id_block

Block the given account. Clients should filter statuses from this account if received (e.g. due to a boost in the Home timeline).

post_api_v1_accounts_id_follow

Follow the given account. Can also be used to update whether to show reblogs or enable notifications.

post_api_v1_accounts_id_mute

Mute the given account. Clients should filter statuses and notifications from this account, if received (e.g. due to a boost in the Home timeline).

post_api_v1_accounts_id_note

Sets a private note on a user.

post_api_v1_accounts_id_pin

Add the given account to the user's featured profiles. (Featured profiles are currently shown on the user's own public profile.)

post_api_v1_accounts_id_unblock

Block the given account. Clients should filter statuses from this account if received (e.g. due to a boost in the Home timeline).

post_api_v1_accounts_id_unfollow

Unfollow the given account.

post_api_v1_accounts_id_unmute

Unmute the given account.

post_api_v1_accounts_id_unpin

Remove the given account from the user's featured profiles.

post_api_v1_admin_accounts_id_action

Perform an action against an account and log this action in the moderation history.

post_api_v1_admin_accounts_id_approve

Approve the given local account if it is currently pending approval.

post_api_v1_admin_accounts_id_enable

Re-enable a local account whose login is currently disabled.

post_api_v1_admin_accounts_id_reject

Reject the given local account if it is currently pending approval.

post_api_v1_admin_accounts_id_unsilence

Unsilence a currently silenced account.

post_api_v1_admin_accounts_id_unsuspend

Unsuspend a currently suspended account.

post_api_v1_admin_reports_id_assign_to_self

Claim the handling of this report to yourself.

post_api_v1_admin_reports_id_reopen

Mark a report as resolved with no further action taken.

post_api_v1_admin_reports_id_resolve

Mark a report as resolved with no further action taken.

post_api_v1_admin_reports_id_unassign

Unassign a report so that someone else can claim it.

post_api_v1_announcements_id_dismiss

Allows a user to mark the announcement as read.

post_api_v1_apps

Create a new application to obtain OAuth2 credentials.

post_api_v1_conversations_id_read

Remove converstation

post_api_v1_domain_blocks

"Block a domain to: - hide all public posts from it - hide all notifications from it - remove all followers from it - prevent following new users from it (but does not remove existing follows)"

post_api_v1_featured_tags

Create a feature a tag.

post_api_v1_filters

post_api_v1_follow_requests_id_authorize

Accept Follow

post_api_v1_follow_requests_id_reject

Accept Follow

post_api_v1_lists

Create a new list.

post_api_v1_lists_id_accounts

Add accounts to the given list. Note that the user must be following these accounts.

post_api_v1_markers

Get saved timeline position

post_api_v1_media

Creates an attachment to be used with a new status.

post_api_v1_media_id

Update an Attachment, before it is attached to a status and posted.

post_api_v1_notifications_clear

Clear all notifications from the server.

post_api_v1_notifications_id_dismiss

Clear a single notification from the server.

post_api_v1_polls_id

Vote on a poll.

post_api_v1_push_subscription

Add a Web Push API subscription to receive notifications. Each access token can have one push subscription. If you create a new subscription, the old subscription is deleted.

post_api_v1_reports

File a report.

post_api_v1_statuses

post_api_v1_statuses_id_bookmark

Privately bookmark a status.

post_api_v1_statuses_id_favourite

Add a status to your favourites list.

post_api_v1_statuses_id_mute

Do not receive notifications for the thread that this status is part of. Must be a thread in which you are a participant.

post_api_v1_statuses_id_pin

Feature one of your own public statuses at the top of your profile.