> ## Documentation Index
> Fetch the complete documentation index at: https://x-preview-mintlify-6d8eadf6.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Batch Compliance
> Use the X API v2 Batch Compliance endpoints to upload Post ID or user ID datasets and retrieve current compliance status for deletions, suspensions, and edits.
export const Button = ({href, children}) => {
return ;
};
The Batch Compliance endpoints let you upload datasets of Post IDs or user IDs and receive their current compliance status. Use this to identify deleted Posts, suspended accounts, and other compliance events.
## Overview
Check status of Posts in bulk
Check status of users in bulk
Submit jobs and retrieve results later
Process millions of IDs
***
## How it works
1. **Create a job** — Specify the type (Posts or users) and upload URL
2. **Upload IDs** — Upload your dataset to the provided URL
3. **Wait for processing** — Job processes asynchronously
4. **Download results** — Get compliance status for each ID
***
## Endpoints
| Method | Endpoint | Description |
| :----- | :--------------------------------------------------------------------- | :---------------------------------------------------- |
| POST | [`/2/compliance/jobs`](/x-api/compliance/create-compliance-job) | Create a new compliance job |
| GET | [`/2/compliance/jobs/:id`](/x-api/compliance/get-compliance-job-by-id) | Get job status |
| GET | [`/2/compliance/jobs`](/x-api/compliance/get-compliance-jobs) | List all jobs |
| PUT | [`upload_url`](/x-api/compliance/upload-compliance-job-submission) | Upload your ID dataset (URL returned at job creation) |
| GET | [`download_url`](/x-api/compliance/download-compliance-job-results) | Download results (URL returned at job creation) |
| DELETE | [`/2/compliance/jobs/:id`](/x-api/compliance/cancel-compliance-job) | Cancel a job awaiting upload or processing |
***
## Job types
| Type | Description |
| :------- | :--------------------------- |
| `tweets` | Check Post compliance status |
| `users` | Check user compliance status |
***
## Compliance events
Results carry an `action` — what you should do with your stored copy — and a
`reason` — why.
### Post events
| Action | Reason | Description |
| :---------- | :------------- | :---------------------------------------------------------------------- |
| `delete` | `deleted` | Post was deleted |
| `delete` | `protected` | Author's account became protected |
| `delete` | `deactivated` | Author's account was deactivated |
| `delete` | `suspended` | Author's account was suspended |
| `rehydrate` | `tweet_edited` | Post was edited; re-fetch it to get the current revision |
| `scrub_geo` | `geo_scrubbed` | Author removed geo data from their Posts; delete stored geo information |
### User events
| Action | Reason | Description |
| :------- | :------------ | :----------------------- |
| `delete` | `deleted` | Account was deleted |
| `delete` | `protected` | Account became protected |
| `delete` | `deactivated` | Account was deactivated |
| `delete` | `suspended` | Account was suspended |
***
## Example: Create a job
```bash theme={null}
curl -X POST "https://api.x.com/2/compliance/jobs" \
-H "Authorization: Bearer $BEARER_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"type": "tweets",
"name": "my-compliance-job"
}'
```
***
## 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
* Your App's [Bearer Token](/resources/fundamentals/authentication)
Create your first compliance job
Key concepts and best practices
Full endpoint documentation