If you are an AI agent, LLM, or automated tool, a clean markdown version of this page is available at https://www.socialfetch.dev/docs/api/v1/lemmy/user/get.mdx.
The Lemmy instance, e.g. `lemmy.world`. A URL on the instance is also accepted. Ids and counts belong to this instance.
usernamestringoptionalquery
Username, e.g. `dessalines`, or `user@lemmy.ml` to resolve a user on another instance.
idintegeroptionalquery
User id on the chosen instance, e.g. `34`.
≥ 1 · ≤ 2147483647
Response fields
307
Endpoint-specific response payload.
data.lookupStatus
string
`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
data.instance
string
The instance that was asked.
Why `lookupStatus` is not `found`, or null when it is `found`.
data.reason.code
string
Machine-readable reason.
one of: instance_private, not_a_lemmy_instance, not_available, deleted, host_not_found
data.reason.message
string
Plain-language explanation.
The profile when `lookupStatus` is `found`; otherwise null.
data.user.id
integer
User id on this instance.
data.user.name
string
Username without the host.
data.user.displayName
stringnullable
Display name.
data.user.bio
stringnullable
Profile text as Markdown.
data.user.avatar
stringnullable
Avatar URL.
data.user.banner
stringnullable
Banner URL.
data.user.actorId
stringnullable
Canonical ActivityPub id.
data.user.host
stringnullable
Host the account lives on.
data.user.handle
stringnullable
`user@host`.
data.user.publishedAt
stringnullable
When the account was created.
data.user.updatedAt
stringnullable
When the profile last changed.
data.user.banned
booleannullable
Whether the account is banned.
data.user.banExpiresAt
stringnullable
When the ban ends.
data.user.deleted
booleannullable
Whether the account was deleted.
data.user.isBot
booleannullable
Whether the account is a bot.
data.user.isLocal
booleannullable
Whether the account lives on the instance asked.
data.user.matrixUserId
stringnullable
Matrix id the user chose to publish.
data.user.postCount
integernullable
Posts the user has made.
data.user.commentCount
integernullable
Comments the user has made.
data.user.postScore
integernullable
Combined score of the user's posts, when the instance reports it.
data.user.commentScore
integernullable
Combined score of the user's comments, when the instance reports it.
data.user.isAdmin
booleannullable
Whether the user is an instance administrator.
Communities the user moderates; null when the answer did not carry them.
data.user.moderates[].id
integer
Community id on this instance.
data.user.moderates[].name
string
Community name without the host.
data.user.moderates[].title
stringnullable
Display title.
data.user.moderates[].actorId
stringnullable
Canonical ActivityPub id.
data.user.moderates[].host
stringnullable
Host the community lives on.
data.user.moderates[].handle
stringnullable
`name@host`.
data.user.moderates[].icon
stringnullable
Community icon URL.
data.user.moderates[].nsfw
booleannullable
Whether the community is NSFW.
data.user.moderates[].isLocal
booleannullable
Whether the community lives on the instance asked.
The newest post, from the user lookup. Use the user posts endpoint for more.
data.posts[].id
integer
Post id on this instance.
data.posts[].apId
stringnullable
Canonical ActivityPub id.
data.posts[].title
stringnullable
Post title.
data.posts[].url
stringnullable
Link the post points at; null for a text post.
data.posts[].urlContentType
stringnullable
Content type of the link.
data.posts[].thumbnailUrl
stringnullable
Thumbnail URL.
data.posts[].nsfw
booleannullable
Whether the post is NSFW.
data.posts[].locked
booleannullable
Whether the post is locked.
data.posts[].removed
booleannullable
Whether a moderator removed it.
data.posts[].deleted
booleannullable
Whether it was deleted.
data.posts[].publishedAt
stringnullable
When it was posted.
data.posts[].updatedAt
stringnullable
When it last changed.
data.posts[].languageId
integernullable
Discussion language id.
data.posts[].isLocal
booleannullable
Whether it was posted on the instance asked.
data.posts[].score
integernullable
Votes up minus votes down.
data.posts[].upvotes
integernullable
Upvotes.
data.posts[].downvotes
integernullable
Downvotes.
data.posts[].commentCount
integernullable
Comments on the post.
The community it was posted in, with the counts the single-post answer carries.
data.posts[].community.id
integer
Community id on this instance.
data.posts[].community.name
string
Community name without the host.
data.posts[].community.title
stringnullable
Display title.
data.posts[].community.actorId
stringnullable
Canonical ActivityPub id.
data.posts[].community.host
stringnullable
Host the community lives on.
data.posts[].community.handle
stringnullable
`name@host`.
data.posts[].community.icon
stringnullable
Community icon URL.
data.posts[].community.nsfw
booleannullable
Whether the community is NSFW.
data.posts[].community.isLocal
booleannullable
Whether the community lives on the instance asked.
data.posts[].community.description
stringnullable
Description as Markdown.
data.posts[].community.banner
stringnullable
Banner URL.
data.posts[].community.publishedAt
stringnullable
When the community was created.
data.posts[].community.updatedAt
stringnullable
When the community last changed.
data.posts[].community.removed
booleannullable
Whether a moderator removed the community.
data.posts[].community.deleted
booleannullable
Whether the community was deleted.
data.posts[].community.hidden
booleannullable
Whether the community is hidden.
data.posts[].community.postingRestrictedToMods
booleannullable
Whether only moderators may post.
data.posts[].community.visibility
stringnullable
`Public` or another visibility the instance reports.
data.posts[].community.subscriberCount
integernullable
Subscribers.
data.posts[].community.localSubscriberCount
integernullable
Subscribers on the community's own instance.
data.posts[].community.postCount
integernullable
Posts in the community.
data.posts[].community.commentCount
integernullable
Comments in the community.
Active users in the community.
data.posts[].community.activeUsers.day
integernullable
Active users today.
data.posts[].community.activeUsers.week
integernullable
Active users this week.
data.posts[].community.activeUsers.month
integernullable
Active users this month.
data.posts[].community.activeUsers.halfYear
integernullable
Active users in the last six months.
Moderators; null on list rows, which do not carry them.
data.posts[].community.moderators[].id
integer
User id on this instance.
data.posts[].community.moderators[].name
string
Username without the host.
data.posts[].community.moderators[].displayName
stringnullable
Display name.
data.posts[].community.moderators[].bio
stringnullable
Profile text as Markdown.
data.posts[].community.moderators[].avatar
stringnullable
Avatar URL.
data.posts[].community.moderators[].banner
stringnullable
Banner URL.
data.posts[].community.moderators[].actorId
stringnullable
Canonical ActivityPub id.
data.posts[].community.moderators[].host
stringnullable
Host the account lives on.
data.posts[].community.moderators[].handle
stringnullable
`user@host`.
data.posts[].community.moderators[].publishedAt
stringnullable
When the account was created.
data.posts[].community.moderators[].updatedAt
stringnullable
When the profile last changed.
data.posts[].community.moderators[].banned
booleannullable
Whether the account is banned.
data.posts[].community.moderators[].banExpiresAt
stringnullable
When the ban ends.
data.posts[].community.moderators[].deleted
booleannullable
Whether the account was deleted.
data.posts[].community.moderators[].isBot
booleannullable
Whether the account is a bot.
data.posts[].community.moderators[].isLocal
booleannullable
Whether the account lives on the instance asked.
data.posts[].community.moderators[].matrixUserId
stringnullable
Matrix id the user chose to publish.
Discussion language ids; null on rows that do not carry them. The instance endpoint maps ids to language codes.
data.posts[].community.languageIds[]
integeroptional
Who posted it; null on a modlog row, which does not carry the creator.
data.posts[].author.id
integer
User id on this instance.
data.posts[].author.name
string
Username without the host.
data.posts[].author.displayName
stringnullable
Display name.
data.posts[].author.bio
stringnullable
Profile text as Markdown.
data.posts[].author.avatar
stringnullable
Avatar URL.
data.posts[].author.banner
stringnullable
Banner URL.
data.posts[].author.actorId
stringnullable
Canonical ActivityPub id.
data.posts[].author.host
stringnullable
Host the account lives on.
data.posts[].author.handle
stringnullable
`user@host`.
data.posts[].author.publishedAt
stringnullable
When the account was created.
data.posts[].author.updatedAt
stringnullable
When the profile last changed.
data.posts[].author.banned
booleannullable
Whether the account is banned.
data.posts[].author.banExpiresAt
stringnullable
When the ban ends.
data.posts[].author.deleted
booleannullable
Whether the account was deleted.
data.posts[].author.isBot
booleannullable
Whether the account is a bot.
data.posts[].author.isLocal
booleannullable
Whether the account lives on the instance asked.
data.posts[].author.matrixUserId
stringnullable
Matrix id the user chose to publish.
data.posts[].body
stringnullable
Post text as Markdown.
Link preview; null when the instance found none.
data.posts[].embed.title
stringnullable
Embedded page title.
data.posts[].embed.description
stringnullable
Embedded page description.
data.posts[].embed.videoUrl
stringnullable
Embedded video URL.
data.posts[].altText
stringnullable
Alt text for the image.
Image details; null when the post has no image.
data.posts[].image.link
string
Image URL.
data.posts[].image.width
integernullable
Width in pixels.
data.posts[].image.height
integernullable
Height in pixels.
data.posts[].image.contentType
stringnullable
Media type.
data.posts[].featuredInCommunity
booleannullable
Whether it is featured in its community.
data.posts[].featuredOnInstance
booleannullable
Whether it is featured on the instance.
data.posts[].newestCommentAt
stringnullable
When the newest comment was made.
data.posts[].isAdmin
booleannullable
Whether the author is an instance administrator.
data.posts[].isModerator
booleannullable
Whether the author moderates the community.
data.posts[].bannedFromCommunity
booleannullable
Whether the author is banned from the community.
Posts of the same link in other communities; null on list rows.
data.posts[].crossPosts[].id
integer
Post id on this instance.
data.posts[].crossPosts[].apId
stringnullable
Canonical ActivityPub id.
data.posts[].crossPosts[].title
stringnullable
Post title.
data.posts[].crossPosts[].url
stringnullable
Link the post points at; null for a text post.
data.posts[].crossPosts[].urlContentType
stringnullable
Content type of the link.
data.posts[].crossPosts[].thumbnailUrl
stringnullable
Thumbnail URL.
data.posts[].crossPosts[].nsfw
booleannullable
Whether the post is NSFW.
data.posts[].crossPosts[].locked
booleannullable
Whether the post is locked.
data.posts[].crossPosts[].removed
booleannullable
Whether a moderator removed it.
data.posts[].crossPosts[].deleted
booleannullable
Whether it was deleted.
data.posts[].crossPosts[].publishedAt
stringnullable
When it was posted.
data.posts[].crossPosts[].updatedAt
stringnullable
When it last changed.
data.posts[].crossPosts[].languageId
integernullable
Discussion language id.
data.posts[].crossPosts[].isLocal
booleannullable
Whether it was posted on the instance asked.
data.posts[].crossPosts[].score
integernullable
Votes up minus votes down.
data.posts[].crossPosts[].upvotes
integernullable
Upvotes.
data.posts[].crossPosts[].downvotes
integernullable
Downvotes.
data.posts[].crossPosts[].commentCount
integernullable
Comments on the post.
The community it was posted in.
data.posts[].crossPosts[].community.id
integer
Community id on this instance.
data.posts[].crossPosts[].community.name
string
Community name without the host.
data.posts[].crossPosts[].community.title
stringnullable
Display title.
data.posts[].crossPosts[].community.actorId
stringnullable
Canonical ActivityPub id.
data.posts[].crossPosts[].community.host
stringnullable
Host the community lives on.
data.posts[].crossPosts[].community.handle
stringnullable
`name@host`.
data.posts[].crossPosts[].community.icon
stringnullable
Community icon URL.
data.posts[].crossPosts[].community.nsfw
booleannullable
Whether the community is NSFW.
data.posts[].crossPosts[].community.isLocal
booleannullable
Whether the community lives on the instance asked.
Who posted it; null on a modlog row, which does not carry the creator.
data.posts[].crossPosts[].author.id
integer
User id on this instance.
data.posts[].crossPosts[].author.name
string
Username without the host.
data.posts[].crossPosts[].author.displayName
stringnullable
Display name.
data.posts[].crossPosts[].author.bio
stringnullable
Profile text as Markdown.
data.posts[].crossPosts[].author.avatar
stringnullable
Avatar URL.
data.posts[].crossPosts[].author.banner
stringnullable
Banner URL.
data.posts[].crossPosts[].author.actorId
stringnullable
Canonical ActivityPub id.
data.posts[].crossPosts[].author.host
stringnullable
Host the account lives on.
data.posts[].crossPosts[].author.handle
stringnullable
`user@host`.
data.posts[].crossPosts[].author.publishedAt
stringnullable
When the account was created.
data.posts[].crossPosts[].author.updatedAt
stringnullable
When the profile last changed.
data.posts[].crossPosts[].author.banned
booleannullable
Whether the account is banned.
data.posts[].crossPosts[].author.banExpiresAt
stringnullable
When the ban ends.
data.posts[].crossPosts[].author.deleted
booleannullable
Whether the account was deleted.
data.posts[].crossPosts[].author.isBot
booleannullable
Whether the account is a bot.
data.posts[].crossPosts[].author.isLocal
booleannullable
Whether the account lives on the instance asked.
data.posts[].crossPosts[].author.matrixUserId
stringnullable
Matrix id the user chose to publish.
Moderators of the community; null on list rows, which do not carry them.
data.posts[].moderators[].id
integer
User id on this instance.
data.posts[].moderators[].name
string
Username without the host.
data.posts[].moderators[].displayName
stringnullable
Display name.
data.posts[].moderators[].bio
stringnullable
Profile text as Markdown.
data.posts[].moderators[].avatar
stringnullable
Avatar URL.
data.posts[].moderators[].banner
stringnullable
Banner URL.
data.posts[].moderators[].actorId
stringnullable
Canonical ActivityPub id.
data.posts[].moderators[].host
stringnullable
Host the account lives on.
data.posts[].moderators[].handle
stringnullable
`user@host`.
data.posts[].moderators[].publishedAt
stringnullable
When the account was created.
data.posts[].moderators[].updatedAt
stringnullable
When the profile last changed.
data.posts[].moderators[].banned
booleannullable
Whether the account is banned.
data.posts[].moderators[].banExpiresAt
stringnullable
When the ban ends.
data.posts[].moderators[].deleted
booleannullable
Whether the account was deleted.
data.posts[].moderators[].isBot
booleannullable
Whether the account is a bot.
data.posts[].moderators[].isLocal
booleannullable
Whether the account lives on the instance asked.
data.posts[].moderators[].matrixUserId
stringnullable
Matrix id the user chose to publish.
The newest comment, from the user lookup. Use the user comments endpoint for more.
data.comments[].id
integer
Comment id on this instance.
data.comments[].apId
stringnullable
Canonical ActivityPub id.
data.comments[].content
stringnullable
Comment text as Markdown; empty when a moderator removed it or its author deleted it.
data.comments[].postId
integernullable
The post it belongs to.
data.comments[].path
stringnullable
The dotted ancestor chain, from the root post (`0.1234.5678`).
data.comments[].depth
integernullable
Depth in the tree, from `path`.
data.comments[].parentId
integernullable
The comment it replies to; null for a top-level comment.
data.comments[].distinguished
booleannullable
Whether a moderator marked it as a moderator comment.
data.comments[].languageId
integernullable
Discussion language id.
data.comments[].isLocal
booleannullable
Whether it was written on the instance asked.
data.comments[].removed
booleannullable
Whether a moderator removed it.
data.comments[].deleted
booleannullable
Whether its author deleted it.
data.comments[].publishedAt
stringnullable
When it was written.
data.comments[].updatedAt
stringnullable
When it last changed.
data.comments[].score
integernullable
Votes up minus votes down.
data.comments[].upvotes
integernullable
Upvotes.
data.comments[].downvotes
integernullable
Downvotes.
data.comments[].replyCount
integernullable
Direct replies.
data.comments[].isAdmin
booleannullable
Whether the author is an instance administrator.
data.comments[].isModerator
booleannullable
Whether the author moderates the community.
data.comments[].bannedFromCommunity
booleannullable
Whether the author is banned from the community.
The post it belongs to.
data.comments[].post.id
integer
Post id on this instance.
data.comments[].post.apId
stringnullable
Canonical ActivityPub id.
data.comments[].post.title
stringnullable
Post title.
data.comments[].post.url
stringnullable
Link the post points at; null for a text post.
data.comments[].post.urlContentType
stringnullable
Content type of the link.
data.comments[].post.thumbnailUrl
stringnullable
Thumbnail URL.
data.comments[].post.nsfw
booleannullable
Whether the post is NSFW.
data.comments[].post.locked
booleannullable
Whether the post is locked.
data.comments[].post.removed
booleannullable
Whether a moderator removed it.
data.comments[].post.deleted
booleannullable
Whether it was deleted.
data.comments[].post.publishedAt
stringnullable
When it was posted.
data.comments[].post.updatedAt
stringnullable
When it last changed.
data.comments[].post.languageId
integernullable
Discussion language id.
data.comments[].post.isLocal
booleannullable
Whether it was posted on the instance asked.
data.comments[].post.score
integernullable
Votes up minus votes down.
data.comments[].post.upvotes
integernullable
Upvotes.
data.comments[].post.downvotes
integernullable
Downvotes.
data.comments[].post.commentCount
integernullable
Comments on the post.
The community it was posted in.
data.comments[].post.community.id
integer
Community id on this instance.
data.comments[].post.community.name
string
Community name without the host.
data.comments[].post.community.title
stringnullable
Display title.
data.comments[].post.community.actorId
stringnullable
Canonical ActivityPub id.
data.comments[].post.community.host
stringnullable
Host the community lives on.
data.comments[].post.community.handle
stringnullable
`name@host`.
data.comments[].post.community.icon
stringnullable
Community icon URL.
data.comments[].post.community.nsfw
booleannullable
Whether the community is NSFW.
data.comments[].post.community.isLocal
booleannullable
Whether the community lives on the instance asked.
Who posted it; null on a modlog row, which does not carry the creator.
data.comments[].post.author.id
integer
User id on this instance.
data.comments[].post.author.name
string
Username without the host.
data.comments[].post.author.displayName
stringnullable
Display name.
data.comments[].post.author.bio
stringnullable
Profile text as Markdown.
data.comments[].post.author.avatar
stringnullable
Avatar URL.
data.comments[].post.author.banner
stringnullable
Banner URL.
data.comments[].post.author.actorId
stringnullable
Canonical ActivityPub id.
data.comments[].post.author.host
stringnullable
Host the account lives on.
data.comments[].post.author.handle
stringnullable
`user@host`.
data.comments[].post.author.publishedAt
stringnullable
When the account was created.
data.comments[].post.author.updatedAt
stringnullable
When the profile last changed.
data.comments[].post.author.banned
booleannullable
Whether the account is banned.
data.comments[].post.author.banExpiresAt
stringnullable
When the ban ends.
data.comments[].post.author.deleted
booleannullable
Whether the account was deleted.
data.comments[].post.author.isBot
booleannullable
Whether the account is a bot.
data.comments[].post.author.isLocal
booleannullable
Whether the account lives on the instance asked.
data.comments[].post.author.matrixUserId
stringnullable
Matrix id the user chose to publish.
The community of the post.
data.comments[].community.id
integer
Community id on this instance.
data.comments[].community.name
string
Community name without the host.
data.comments[].community.title
stringnullable
Display title.
data.comments[].community.actorId
stringnullable
Canonical ActivityPub id.
data.comments[].community.host
stringnullable
Host the community lives on.
data.comments[].community.handle
stringnullable
`name@host`.
data.comments[].community.icon
stringnullable
Community icon URL.
data.comments[].community.nsfw
booleannullable
Whether the community is NSFW.
data.comments[].community.isLocal
booleannullable
Whether the community lives on the instance asked.
Who wrote it.
data.comments[].author.id
integer
User id on this instance.
data.comments[].author.name
string
Username without the host.
data.comments[].author.displayName
stringnullable
Display name.
data.comments[].author.bio
stringnullable
Profile text as Markdown.
data.comments[].author.avatar
stringnullable
Avatar URL.
data.comments[].author.banner
stringnullable
Banner URL.
data.comments[].author.actorId
stringnullable
Canonical ActivityPub id.
data.comments[].author.host
stringnullable
Host the account lives on.
data.comments[].author.handle
stringnullable
`user@host`.
data.comments[].author.publishedAt
stringnullable
When the account was created.
data.comments[].author.updatedAt
stringnullable
When the profile last changed.
data.comments[].author.banned
booleannullable
Whether the account is banned.
data.comments[].author.banExpiresAt
stringnullable
When the ban ends.
data.comments[].author.deleted
booleannullable
Whether the account was deleted.
data.comments[].author.isBot
booleannullable
Whether the account is a bot.
data.comments[].author.isLocal
booleannullable
Whether the account lives on the instance asked.
data.comments[].author.matrixUserId
stringnullable
Matrix id the user chose to publish.
Metadata describing the request and billing outcome.
meta.requestId
string
Unique request identifier for tracing this API call.