Accounts

List Accounts

Returns all OnlyFans accounts linked to the authenticated organization. Connected accounts come first, then accounts with sync lost. Fansly/ChatBlue/Subs accounts and offboarded/deleted accounts are excluded. Requires permission api_accounts_list.

https://public-api.fansmetric.com

GET/v1/accounts

API keyBearer

Authorization

default

AuthorizationBearer <token>

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

In: header

Query Parameters

limitinteger
Number of accounts per page. Default 20. Min 1, max 50 (values above 50 are clamped).
offsetinteger
Number of accounts to skip.

Response Fields

data[]array
Account objects for the current page.
data[].account_idinteger
OnlyFans numeric user ID — used as account_id for other endpoints.
data[].usernamestring
OnlyFans username / URL handle.
data[].display_namestring
Display name on OnlyFans (may include emoji).
data[].avatarstring
Full-size avatar URL.
data[].avatar_thumbsobject | null
Thumbnail avatar URLs (c50, c144). null if not available.
data[].fm_planstring
FansMetric plan: standard or pro.
data[].fm_statusstring
connected or sync_lost.
totalinteger
Total accounts across all pages.
limitinteger
Applied page size after clamping.
offsetinteger
Applied offset.
next_pagestring | null
Relative URL for the next page. null on the last page.
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[]	array	Account objects for the current page.
data[].account_id	integer	OnlyFans numeric user ID — used as `account_id` for other endpoints.
data[].username	string	OnlyFans username / URL handle.
data[].display_name	string	Display name on OnlyFans (may include emoji).
data[].avatar	string	Full-size avatar URL.
data[].avatar_thumbs	object \| null	Thumbnail avatar URLs (`c50`, `c144`). `null` if not available.
data[].fm_plan	string	FansMetric plan: `standard` or `pro`.
data[].fm_status	string	`connected` or `sync_lost`.
total	integer	Total accounts across all pages.
limit	integer	Applied page size after clamping.
offset	integer	Applied offset.
next_page	string \| null	Relative URL for the next page. `null` on the last page.
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/accounts?limit=20&offset=0" \
  --header "Authorization: Bearer YOUR_API_KEY"

Response

200

{"data":[0:{"account_id":10000001
"username":"creator_XXXXX"
"display_name":"Creator XX"
"avatar":"https://public.onlyfans.com/files/.../avatar.jpg"
"avatar_thumbs":{"c50":"https://thumbs.onlyfans.com/.../c50/.../avatar.jpg"
"c144":"https://thumbs.onlyfans.com/.../c144/.../avatar.jpg"
}
"fm_plan":"pro"
"fm_status":"connected"
}
]
"total":7
"limit":20
"offset":0
"next_page":null
}

August 17, 2026

Who Am I