GET
List blocked users

Overview

Returns the users the authenticated caller has directed-blocked (callerUserId → blockedUserId), newest block first. Each entry is enriched with the blocked user’s display info (firstName, lastName, avatarUrl) using the same user-profile lookup the conversation inbox uses, so the block list renders without a per-row follow-up call. Use each entry’s userId to unblock via DELETE /api/v1/chat/blocks/:userId. The list is directed: it only contains blocks the caller created. Blocks that other users created against the caller are not returned.

Authentication

Bearer <accessToken> required. requireOnboarded middleware applied.

Path parameters

None.

Query parameters

None. The endpoint returns the caller’s full block list (no pagination).

Request body

None.

Response — 200 OK

Example response (two blocks)

Example response (no blocks)

Example response (blocked user record removed)

If a blocked user’s account is gone, the row is still returned (so the caller can still unblock) with null profile fields:

Error responses

See also

curl