> ## Documentation Index
> Fetch the complete documentation index at: https://x-preview-mintlify-d8fc0171.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Blocks
> The Blocks endpoints let you retrieve the list of users blocked by the authenticated user, as well. Reference for the X API v2 standard tier covering blocks.
export const Button = ({href, children}) => {
return ;
};
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](/forms/enterprise-api-interest).
## Overview
Get your blocked user list
Block a user
Unblock a user
***
## Endpoints
| Method | Endpoint | Description | Availability |
| :----- | :--------------------------------------------------- | :---------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| GET | [`/2/users/:id/blocking`](/x-api/users/get-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
```bash theme={null}
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)
```bash theme={null}
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](https://developer.x.com/en/portal/petition/essential/basic-info)
* A [Project and App](/resources/fundamentals/developer-apps) in the Developer Console
* User Access Tokens via [OAuth 2.0 PKCE](/resources/fundamentals/authentication#oauth-2-0-authorization-code-flow-with-pkce-2)
Get started with blocks
Key concepts and best practices
Full endpoint documentation