API reference

List accounts you created

Accounts your app created through create-account, newest first, with their current status.

View as MarkdownUpdated Oct 17, 2026

GET/api/external/v1/accountsalso served at /api/external/accountsNew

Accounts your app created through create-account, newest first, with their current status.

Authentication

Send the creator's API key as a bearer token: Authorization: Bearer dpfn_…. See Authentication & API keys.

Query parameters

Name	Type	Required	Description
`limit`	integer	Optional	Page size. Default: `50` Min: 1 Max: 100
`cursor`	string	Optional	`nextCursor` from the previous page.

Responses

200A page of accounts.

Name Type Description

accounts

CrmAccount[]

Newest first.

Show child attributes

`accountId`	string	The new account’s id.
`username`	string	Public @handle (without @).
`displayName`	string \| null	Display name.
`email`	string \| null	Sign-in email. Format: email
`accountType`	string	What the account was created as. One of: `creator`, `agency`
`status`	string	`pending_kyc` until the ID check is approved, then `active` (can sell and get paid). One of: `pending_kyc`, `active`
`sellerStatus`	string	Internal seller state, for support (PENDING_KYC, KYC_IN_REVIEW, KYC_REJECTED, VERIFIED_CREATOR, VERIFIED_AGENCY).
`kycStatus`	string	ID-check state. `session_created` = link opened, not finished; `processing` = approved, compliance documents still being generated. One of: `not_started`, `session_created`, `in_review`, `processing`, `approved`, `rejected`
`profileUrl`	string	Public profile URL. Format: uri
`createdAt`	string	When the account was created. Format: date-time

nextCursor string | null Null on the last page.

Example response

{
  "accounts": [
    {
      "accountId": "clxac0001acct",
      "username": "valeria",
      "displayName": "Valeria",
      "email": "valeria@example.com",
      "accountType": "creator",
      "status": "pending_kyc",
      "sellerStatus": "PENDING_KYC",
      "kycStatus": "session_created",
      "profileUrl": "https://www.dropfans.io/u/valeria",
      "createdAt": "2026-10-17T16:00:00.000Z"
    }
  ],
  "nextCursor": null
}

Errors

Status	Body	When
401	`{"error":"Unauthorized","code":"unauthorized"}`	Missing or invalid API key.
403	`{"error":"This endpoint needs a key bound to an approved app.","code":"app_key_required"}`	A Personal key was used.
403	`{"error":"Use the app owner's key for this endpoint.","code":"owner_key_required"}`	The key was minted by a creator for themselves. App-level calls need a key held by your app owner: their own, or one their agency minted for its personas or managed creators.
400	`{"error":"This endpoint acts as the key’s own account or app — call it without /creators/{creatorId}.","code":"creator_scope_not_allowed"}`	Called under /api/external/v1/creators/{creatorId}/ — this endpoint always acts as the key’s own account, agency or app.
403	`{"error":"This app does not have the onboarding API category enabled. Contact support to enable it.","code":"api_category_disabled","category":"onboarding"}`	Your app has the Creator onboarding [API category](/developers/concepts/api-categories) switched off (the default for new apps).

Rate limiting

Every response carries the X-RateLimit-Tier header and, on limited tiers, the per-minute and per-day trios — read X-RateLimit-Remaining and X-RateLimit-Reset instead of hardcoding limits. Details in Rate limits.

Code samples

curl "https://www.dropfans.io/api/external/v1/accounts" \
  -H "Authorization: Bearer $DROPFANS_API_KEY"

const res = await fetch(`https://www.dropfans.io/api/external/v1/accounts`, {
  headers: {
    Authorization: `Bearer ${process.env.DROPFANS_API_KEY}`,
  },
});
console.log(await res.json());

import os
import requests

res = requests.get(
    "https://www.dropfans.io/api/external/v1/accounts",
    headers={"Authorization": f"Bearer {os.environ['DROPFANS_API_KEY']}"},
)
print(res.json())

← Previous

Create a creator account (sign-up from your page)

Get an account you created

Questions? support@dropfans.io