Fans

Get Fan Details

Returns full details for a fan — subscription data (both directions), notes, last seen, list memberships, restriction/block state. Requires permission api_fans_read.

https://public-api.fansmetric.com

GET/v1/{account_id}/fans/{user_id}

API keyBearer

Authorization

default

AuthorizationBearer <token>

Send your FansMetric API key as a Bearer token in the Authorization header.

In: header

Path Parameters

account_id*integer
OnlyFans numeric account ID.
user_id*integer
Fan's OnlyFans user ID.

Response Fields

data.idinteger
Fan's OF user ID.
data.namestring
Fan's name.
data.usernamestring
Fan's username.
data.displayNamestring
Custom display name (empty if not set).
data.noticestring
Private notes on the fan.
data.lastSeenstring
Last online timestamp (ISO 8601).
data.isRestrictedboolean
Whether the fan is restricted.
data.isBlockedboolean
Whether the fan is blocked.
data.subscribedByDataobject
Fan's subscription to you.
data.subscribedOnDataobject
Your subscription to the fan.
data.listsStatesarray
Which lists the fan belongs to.
dataobject | array
Endpoint-specific payload. See the fields below for this route.
_meta._credits.usedinteger
Credits consumed by this request (currently always 1).
_meta._rate_limits.limit_minuteinteger
Maximum requests per minute for the organization.
_meta._rate_limits.remaining_minuteinteger
Remaining requests in the current minute window.
_meta._rate_limits.limit_dayinteger
Maximum requests per day for the organization.
_meta._rate_limits.remaining_dayinteger
Remaining requests in the current day window.

Field	Type	Description
data.id	integer	Fan's OF user ID.
data.name	string	Fan's name.
data.username	string	Fan's username.
data.displayName	string	Custom display name (empty if not set).
data.notice	string	Private notes on the fan.
data.lastSeen	string	Last online timestamp (ISO 8601).
data.isRestricted	boolean	Whether the fan is restricted.
data.isBlocked	boolean	Whether the fan is blocked.
data.subscribedByData	object	Fan's subscription to you.
data.subscribedOnData	object	Your subscription to the fan.
data.listsStates	array	Which lists the fan belongs to.
data	object \| array	Endpoint-specific payload. See the fields below for this route.
_meta._credits.used	integer	Credits consumed by this request (currently always `1`).
_meta._rate_limits.limit_minute	integer	Maximum requests per minute for the organization.
_meta._rate_limits.remaining_minute	integer	Remaining requests in the current minute window.
_meta._rate_limits.limit_day	integer	Maximum requests per day for the organization.
_meta._rate_limits.remaining_day	integer	Remaining requests in the current day window.

curl --request GET "https://public-api.fansmetric.com/v1/100000001/fans/sample_user_id" \
  --header "Authorization: Bearer YOUR_API_KEY"

Response

200

{"data":{"id":7128
"username":"creator_XXXXX"
"name":"Creator XX"
"displayName":"Creator XX"
"notice":"VIP fan"
"lastSeen":"2026-05-18T10:00:00+00:00"
"isRestricted":false
"isBlocked":false
}
"_meta":{"_credits":{"used":1
}
"_rate_limits":{"limit_minute":1000
"remaining_minute":990
"limit_day":50000
"remaining_day":49990
}
}
}

List Subscribers

Get Fan Details by IDs