Blocks

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

The block and unblock users endpoints are only available under the Enterprise plan. You can fill out the Enterprise interest form here.

Overview

Blocked users

Get your blocked user list

Block

Block a user

Unblock

Unblock a user

Endpoints

Method	Endpoint	Description	Availability
GET	`/2/users/:id/blocking`	Get blocked users	Pay-per-useEnterprise
POST	`/2/users/:id/blocking`	Block a user	Enterprise
DELETE	`/2/users/:source_user_id/blocking/:target_user_id`	Unblock a user	Enterprise

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 (Enterprise only)

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

Get muting

Quickstart

​Overview

Blocked users

Block

Unblock

​Endpoints

​Example: Get blocked users

​Example: Block a user (Enterprise only)

​Getting started

Quickstart

Integration guide

API Reference

Overview

Endpoints

Example: Get blocked users

Example: Block a user (Enterprise only)

Getting started