Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.onlyfanskit.dev/llms.txt

Use this file to discover all available pages before exploring further.

Start a login with the creator’s email and password. The call returns immediately with an attempt_id; the login runs in the background and you poll until it resolves.
1

Start the attempt

curl -X POST https://api.onlyfanskit.dev/v1/connect/login \
  -H "Authorization: Bearer $OFK_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "creator@example.com",
    "password": "<password>",
    "remember_credentials": true
  }'
Returns 202 with an attempt:
{
  "attempt_id": "att_...",
  "state": "pending",
  "polling_url": "/v1/connect/login/att_..."
}
Set remember_credentials: true to seal the credentials so the account can later be reauthenticated without a fresh login.
2

Poll until it resolves

curl https://api.onlyfanskit.dev/v1/connect/login/$ATTEMPT_ID \
  -H "Authorization: Bearer $OFK_KEY"
Keep polling while state is pending. It ends at completed_success (with an account_id) or parks on a 2FA state.
3

Resolve any challenge

If state becomes needs_otp, needs_app_otp, needs_email, or needs_face_otp, submit the code or signal completion. See Two-factor & challenges.

​
Fields

FieldRequiredNotes
email, passwordfor credentials loginThe creator’s OnlyFans login.
auth_typenocredentials (default) or mobile_app.
remember_credentialsnoStore credentials so the account can be reauthenticated later without a fresh login.
labelnoHuman label.
proxy_countrynoRegion for the account’s traffic — us or uk.
Email/password login may be temporarily unavailable, returning 503. When it is, use a cookie or mobile connect instead — those have no such dependency.