Mastodon

List Mastodon server domain blocks

List the domains a Mastodon server publicly blocks.

GET/v1/mastodon/servers/{host}/blocks
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
1
hoststringrequiredpath

The Mastodon server to ask, e.g. `mastodon.social`. A server URL is also accepted. The server you name is the one that answers.

Response fields
16

Endpoint-specific response payload.

datalookupStatus
string

`found`, `not_found`, `restricted` (login required or closed), `unsupported` (this server does not offer it) or `not_compatible` (the host is not a Mastodon-compatible server). See `reason`.

one of: found, not_found, restricted, unsupported, not_compatible

datahost
string

The server that was asked.

datasoftware
stringnullableoptional

Only on a `not_compatible` result (and always on the server endpoint): the software the host runs, from its NodeInfo, e.g. `misskey` or `lemmy`; null when it does not say. Absent otherwise.

Why `lookupStatus` is not `found`, or null when it is `found`.

datareasoncode
string

Machine-readable reason.

one of: login_required, closed_by_operator, hidden_by_owner, suspended, not_implemented, disabled_by_operator, not_a_mastodon_server, unsupported_server_software, host_not_found, post_not_visible

datareasonmessage
string

Plain-language explanation.

Domains the server publicly blocks.

datablocks[]domain
string

Blocked domain; may be partly starred where the operator hides it.

datablocks[]digest
stringnullable

SHA-256 of the domain.

datablocks[]severity
stringnullable

`suspend`, `silence` or `noop`.

datablocks[]comment
stringnullable

The operator's public reason.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

Code example

curl "https://api.socialfetch.dev/v1/mastodon/servers/mastodon.social/blocks" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Domains the server's operator publicly blocks.