Quickstart

Block and unblock users, and retrieve your block list

This guide walks you through blocking and unblocking users, and retrieving your block list.

Prerequisites

Before you begin, you’ll need:

• A developer account with an approved App
• User Access Token (OAuth 1.0a or OAuth 2.0 PKCE)

---

Get blocked users

1. Get your user ID

   You need your authenticated user’s ID to retrieve your block list. You can get it from the /2/users/me endpoint or use the ID from your tokens.

2. Request your block list

   cURL

   shellscript

   curl "https://api.x.com/2/users/123456789/blocking?\
   user.fields=username,verified,created_at&\
   max_results=100" \
     -H "Authorization: Bearer $USER_ACCESS_TOKEN"
   
3. Review the response

   {
     "data": [
       {
         "id": "17874544",
         "name": "Example User",
         "username": "example_user",
         "verified": false,
         "created_at": "2008-12-04T18:51:57.000Z"
       }
     ],
     "meta": {
       "result_count": 1,
       "next_token": "abc123"
     }
   }
   

---

Block a user

1. Identify the target user

   Get the user ID of the account you want to block.

2. Send a block request

   cURL

   shellscript

   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"}'
   
3. Confirm the block

   {
     "data": {
       "blocking": true
     }
   }
   

---

Unblock a user

1. Send an unblock request

   cURL

   shellscript

   curl -X DELETE "https://api.x.com/2/users/123456789/blocking/9876543210" \
     -H "Authorization: Bearer $USER_ACCESS_TOKEN"
   
2. Confirm the unblock

   {
     "data": {
       "blocking": false
     }
   }
   

---

Next steps

Mutes

Mute users instead of blocking

Follows

Manage follows

Integration guide

Key concepts and best practices

API Reference

Full endpoint documentation