---
title: "List blocked users"
method: GET
path: "/v3/users/{user_id}/block"
tags: ["Moderation"]
---

# List blocked users

`GET /v3/users/{user_id}/block`

## Request

- Base URL: `https://api-APP_ID.sendbird.com`
- URL: `https://api-APP_ID.sendbird.com/v3/users/{user_id}/block`
- Auth: none declared

## List blocked by and blocking users

This action retrieves a list of users who are either blocked by a specific user or a list of users who are blocking a specific user.

[https://sendbird.com/docs/chat/platform-api/v3/moderation/listing-blocked-and-blocking-users/list-blocked-and-blocking-users#1-list-blocked-by-and-blocking-users](https://sendbird.com/docs/chat/platform-api/v3/moderation/listing-blocked-and-blocking-users/list-blocked-and-blocking-users#1-list-blocked-by-and-blocking-users)

`user_id`  
Type: string  
Description: Specifies the unique ID of the target user.

## Path parameters

- `user_id` string, required

## Query parameters

- `list` 'blocked_by_me' | 'blocking_me'
- `token` string
- `limit` integer
- `user_ids` string
- `metadatakey` string
- `metadatavalues_in` string

## Headers

- `api-token` string

## Response `200`

Successful response

- ListBlockedUsersResponse
  - `users` SendbirdUser[]
    - `access_token` string
    - `created_at` integer
    - `discovery_keys` string[], nullable
    - `has_ever_logged_in` boolean
    - `is_active` boolean
    - `is_hide_me_from_friends` boolean
    - `is_online` boolean
    - `is_shadow_blocked` boolean
    - `last_seen_at` integer
    - `locale` string
    - `metadata` object, nullable
    - `nickname` string, nullable
    - `preferred_languages` string[], nullable
    - `profile_url` string
    - `require_auth_for_profile_image` boolean
    - `user_id` string, required
    - `state` '' | 'invited' | 'joined', nullable
    - `unread_channel_count` integer
    - `unread_message_count` integer
    - `phone_number` string
    - `is_created` boolean
  - `next` string

## Changes

- **2025-10-17** `b05d4e3c6329`: 4 breaking, 1 warning, 1 info
  - the response property `users/items/discovery_keys` became nullable for the status `200`
  - the response property `users/items/metadata` became nullable for the status `200`
  - the response property `users/items/nickname` became nullable for the status `200`
  - the response property `users/items/preferred_languages` became nullable for the status `200`
  - …2 more
- **2025-07-27** `7a85bad03e90`: 1 breaking, 5 warning, 6 info
  - the `users/items/session_tokens/items/` response's property type changed from `object` to `string` for status `200`
  - deleted the `header` request parameter `Api-Token`
  - removed the optional property `users/items/description` from the response with the `200` status
  - removed the optional property `users/items/end_at` from the response with the `200` status
  - …8 more
- **2024-09-24** `375ce8bc9c64`: 1 breaking
  - the response property `users/items/` became nullable for the status `200`
- **2023-11-10** `135d8b0705d4`: 1 info
  - the `header` request parameter `Api-Token` became optional
- **2022-10-10** `45e2df0efd62`: 1 breaking
  - the `users/items/session_tokens/items/` response's property type changed from `string` to `object` for status `200`

[Operation history](https://skmtc.dev/sendbird/apis/sendbird-platform-sdk/changes/v3/users/:user_id/block/get.md)

---

[API](https://skmtc.dev/sendbird/apis/sendbird-platform-sdk.md) - [All operations](https://skmtc.dev/sendbird/apis/sendbird-platform-sdk/llms.txt) - [OpenAPI document](https://skmtc.dev/sendbird/apis/sendbird-platform-sdk/revisions/9e53a5288df0?raw)