User Lists
Get User List
Returns metadata for a single custom user list — name, type, members count, sort. Requires permission api_user_lists_read.
https://public-api.buffmetrics.comGET/v1/{account_id}/user-lists/{list_id}
Bearer
Authorization
defaultAuthorizationBearer <token>Send your FansMetric API key as a Bearer token in the Authorization header.
In: header
Path Parameters
account_id*integerOnlyFans numeric account ID.
list_id*integerCustom list ID.
curl --request GET "https://public-api.buffmetrics.com/v1/acct_XXXXX/user-lists/sample_list_id" \
--header "Authorization: Bearer YOUR_API_KEY"Response
200{
"data":{
"id":47382
"type":"custom"
"name":"VIP Fans"
"postsCount":15
"createdAt":"2026-01-12T08:00:00+00:00"
"canUpdate":true
"canDelete":true
}
"_meta":{
"_credits":{
"used":1
}
"_rate_limits":{
"limit_minute":1000
"remaining_minute":999
"limit_day":50000
"remaining_day":49999
}
}
}