Blocks

Block and unblock users, and retrieve blocked user lists

The Blocks endpoints let you block and unblock users, and retrieve the list of users blocked by the authenticated user.

Overview

Block

Block a user

Unblock

Unblock a user

Blocked users

Get your blocked user list

---

Endpoints

Method	Endpoint	Description
GET	/2/users/:id/blocking	Get blocked users
POST	/2/users/:id/blocking	Block a user
DELETE	/2/users/:source_user_id/blocking/:target_user_id	Unblock a user

---

Example: Get blocked users

curl "https://api.x.com/2/users/123456789/blocking?\
user.fields=username,description" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

Example: Block a user

curl -X POST "https://api.x.com/2/users/123456789/blocking" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"target_user_id": "9876543210"}'

---

Getting started

Prerequisites

• An approved developer account
• A Project and App in the Developer Console
• User Access Tokens via OAuth 2.0 PKCE

Quickstart

Get started with blocks

Integration guide

Key concepts and best practices

API Reference

Full endpoint documentation