Twitter status API: is X working?
Checking the Twitter status API tells you whether the X API is answering, and whether a failure comes from X, your access tier or your own code. X publishes status information for its API. The error code tells you the rest.

How to check
Check X's developer status information, then make one plain request with your token. If a simple request works, the service is up. A 429 means you hit a rate limit, a 401 means your credentials were rejected, a 403 means your tier doesn't allow the request, and a 5xx means the problem is on the server.
For the permission case, read Twitter API error 403. For limits, read X rate limit exceeded.
A second path for reading
If you only read public data, a hosted API has its own uptime, separate from X access tiers. See does Twitter have an API and the ChatterAPI status page.
A normal response, for comparison
A profile lookup, a typical read call.
curl "https://api.chatterapi.com/v1/x/users/levelsio" \
-H "Authorization: Bearer $CHATTERAPI_KEY"{
"data": {
"id": "1577241403",
"handle": "levelsio",
"name": "@levelsio",
"bio": "💸http://levels.vc\n📸http://PhotoAI.com $86K/m\n🎮http://VibeJam.com $44K/m\n🏡http://InteriorAI.com $23K/m\n👙@X $13K/m\n🌍http://Nomads.com $7K/m\n🏩http://Hotelist.com $5K/m",
"followers": 974707,
"following": 3276,
"tweets": 181450,
"verified": false,
"blueVerified": true,
"canDm": false,
"protected": false,
"location": "📕My book $5K/m 👉",
"url": "https://readMAKE.com",
"avatarUrl": "https://pbs.twimg.com/profile_images/2077111020305162240/PwddgOau_400x400.jpg",
"createdAt": "2013-07-08T09:31:59.000Z",
"profileUrl": "https://x.com/levelsio",
"bannerUrl": "https://pbs.twimg.com/profile_banners/1577241403/1665964220",
"likesGiven": 185852,
"mediaCount": 19829,
"pinnedTweetIds": [
"2109949585737052316"
]
}
}Recorded from a live call on . Long text is shortened and the cursor is cut. A live key is charged 2 credits for this call. A test key returns this same sample for 0 credits.
Free tools
Questions
Is the Twitter API down?
What does a 403 mean?
Does a hosted API depend on my X tier?
Guides
- X API rate limit exceeded (429): every limit and how to stay under
- How to get an X API key (and when you don't need one)
- Does Twitter have an API? The X API explained