Reddit Account Checker API reference

Description

Check whether a Reddit account is active, suspended, or not visible (deleted, banned or shadowbanned). Returns a state, never an error, for accounts that don't exist. Costs 2 credits. Tip: run it on your own account; not_found_or_banned on an account you can log into means Reddit has shadowbanned it.

Parameters

Name	In	Type	Required	Default	Description
`name`	path	string	yes		Reddit username, with or without u/, or a profile URL. 3-20 characters.

name path, string, required: Reddit username, with or without u/, or a profile URL. 3-20 characters.

Request examples

curl "https://chatterapi.com/v1/reddit/users/spez/status" \
  -H "Authorization: Bearer $CHATTERAPI_KEY"

Response

data is one UserStatus. Fields:

Field	Type	Nullable	Description
`username`	string	no	Username without u/.
`state`	enum	no	active, suspended, not_found_or_banned or unknown.
`exists`	boolean	yes	Whether the account exists, null when unknown.

response

{
  "data": {
    "username": "spez",
    "state": "active",
    "exists": true
  },
  "credits": {
    "charged": 2,
    "remaining": 24997
  },
  "requestId": "req_01JA7Q3V8K2N4P5R6S7T8V",
  "cached": false
}

Recorded live response captured 2026-10-07, truncated to 3 items. Credits and request id are illustrative.

Credits

2 credits per call. Failed calls cost 0. Cached responses cost the same. Test keys cost 0. Repeat calls with the same input within 1 hour are served from cache.