Batch Compliance

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

Post compliance

Check status of Posts in bulk

User compliance

Check status of users in bulk

Asynchronous

Submit jobs and retrieve results later

Large datasets

Process millions of IDs

How it works

Create a job — Specify the type (Posts or users) and upload URL
Upload IDs — Upload your dataset to the provided URL
Wait for processing — Job processes asynchronously
Download results — Get compliance status for each ID

Endpoints

Method	Endpoint	Description
POST	`/2/compliance/jobs`	Create a new compliance job
GET	`/2/compliance/jobs/:id`	Get job status
GET	`/2/compliance/jobs`	List all jobs

Job types

Type	Description
`tweets`	Check Post compliance status
`users`	Check user compliance status

Compliance events

Post events

Event	Description
`deleted`	Post was deleted by user
`bounced`	Post failed compliance check
`protected`	Account became protected
`suspended`	Account was suspended
`scrub_geo`	Geo data was removed

User events

Event	Description
`deleted`	Account was deleted
`suspended`	Account was suspended
`protected`	Account became protected
`deactivated`	Account was deactivated

Example: Create a job

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
A Project and App in the Developer Console
Your App’s Bearer Token

Quickstart

Create your first compliance job

Integration guide

Key concepts and best practices

API Reference

Full endpoint documentation

Terminate all connections

Quickstart

​Overview

Post compliance

User compliance

Asynchronous

Large datasets

​How it works

​Endpoints

​Job types

​Compliance events

​Post events

​User events

​Example: Create a job

​Getting started

Quickstart

Integration guide

API Reference

Overview

How it works

Endpoints

Job types

Compliance events

Post events

User events

Example: Create a job

Getting started