List Lemmy federated instances
List Lemmy federated instances with software, version and delivery status.
Headers
Get your API keyAPI key (`sfk_...`)
The Lemmy instance whose federation table to return, e.g. `fed.dyne.org`. A URL on the instance is also accepted.
Software to keep, matched case-insensitively; `all` keeps every domain. Default: `lemmy`.
min 1 chars · max 40 chars
Only domains whose last successful federation delivery is at or after this time, as an ISO 8601 date or time (such as `2026-01-31`) or epoch seconds. A time with no zone is UTC.
`true` returns the instance's block list; `false` (default) returns the domains it federates with.
Page number. Default: 1. The federated directory has no 100-page ceiling.
≥ 1 · ≤ 1000000
Pass `page.nextCursor` from the previous response to get the next page. It only works with the same filters; do not send it with `page`.
min 1 chars · max 2048 chars
Rows per page, 1 to 50. Default: 10.
≥ 1 · ≤ 50
Endpoint-specific response payload.
`found`, `not_found` (the entity is missing, or the host name does not resolve), `private` (the instance does not allow public lists) or `not_compatible` (the host is not a Lemmy instance, or its version does not serve this operation). See `reason`.
one of: found, not_found, private, not_compatible
The instance that was asked.
Why `lookupStatus` is not `found`, or null when it is `found`.
Machine-readable reason.
one of: instance_private, not_a_lemmy_instance, not_available, deleted, host_not_found
Plain-language explanation.
The software filter this answer used; `all` keeps every domain.
Whether this is the block list.
Rows after the software, activity and block filters.
The rows of this page.
The federated domain.
Software it runs, when known.
Version it reports, when known.
When this instance first saw it.
When its record last changed.
Last successful delivery from it.
Consecutive delivery failures.
Last delivery retry.
Next delivery retry.
Whether this instance blocks it.
Pagination state for the current page.
Current page number. Lemmy pages by number over a live order, so new or re-ranked items can shift a row onto the next page. Remove repeats by `id`.
≥ 0
Whether a full page came back, so another page may exist. A last page that exactly fills the limit still sets true, and the next page is then empty.
Next page number; null when this page was short, so the list ended.
≥ 0
Cursor to pass in the next request; null when this page was short. It only works with the same filters.
True when a full page stopped at the instance's 100-page ceiling and rows may remain. False when the list ended because it ran out.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
curl "https://api.socialfetch.dev/v1/lemmy/instances?source=lemmy.world" \
-H "x-api-key: YOUR_API_KEY"Responses
Federated instance directory.