Skip to main content
GET
Check the follow relationship between two X accounts. Returns whether the source follows the target and whether the target follows the source back. Either account may be given as a username (with or without @) or a numeric user id.
Notification settings (whether the source has post notifications enabled for the target) are not returned — that value is private to the account owner and cannot be read for arbitrary accounts.

Query Parameters

string
required
The account whose following is being checked — @handle, handle, or numeric user id.
string
required
The account being checked against — @handle, handle, or numeric user id.

Response

object
The resolved source account (screen_name, id).
object
The resolved target account (screen_name, id).
boolean
Whether source follows target.
boolean
Whether target follows source.