Authentication Status

Poll the status of an authentication attempt started by Authenticate Account. Use the attempt_id returned by the authentication request, or request the polling_url directly. While authentication is in progress, state is active. Keep polling until it changes to completed. The connected account is then available in returnvalue.

https://v1.onlyfansapi.io

GET

/api/authenticate/{attemptId}

Request

curl --request GET \
  --url 'https://v1.onlyfansapi.io/api/authenticate/{attemptId}' \
  --header 'x-api-key: YOUR_API_KEY'

Headers

x-api-key*

string

Your API key. See Authentication.

Path Parameters

attemptId*

string

The attempt_id returned when the connection attempt was started.

Response Fields

Field	Type	Description
`data`	`object`	The attempt.
`├─ jobId`	`string`	Identifier of the job running the login.
`├─ state`	`string`	`active` while the login is in progress, `completed` once the account is connected.
`├─ message`	`string`	The step the login has reached, ending at `account connected`.
`├─ progress`	`object`	Structured form of the same progress report.
`│ └─ message`	`string`	The step the login has reached.
`├─ email`	`string`	The email address the attempt is signing in with.
`├─ returnvalue`	`object`	The result. `null` until the attempt finishes.
`│ ├─ status`	`string`	Outcome of the job.
`│ └─ result`	`object`	Wrapper around the connection result.
`│ ├─ status`	`string`	Outcome of the connection itself, such as `success`.
`│ └─ result.account`	`object`	The connected account.
`├─ attemptsMade`	`number`	How many attempts the job has made.
`├─ timestamp`	`number`	When the attempt was queued, in epoch milliseconds.
`├─ processedOn`	`number`	When work on the attempt started, in epoch milliseconds.
`└─ finishedOn`	`number`	When the attempt finished, in epoch milliseconds. Absent while it is still running.

The Account Object

Found at data.returnvalue.result.result.account once the attempt completes.

Field	Type	Description
`acct_id`	`string`	Identifier for the connected account, prefixed `acct_`. Use it wherever an endpoint takes an `acct_id`.
`id`	`number`	Internal row ID. Not used by any endpoint.
`user_id`	`string`	Your API user the account belongs to.
`email`	`string`	The email address the account signs in with.
`name`	`string`	The label you sent as `name`.
`country_code`	`string`	The proxy country the account is routed through.
`created_at`	`string`	ISO 8601 timestamp of when the account was connected.
`updated_at`	`string`	ISO 8601 timestamp of the last change to the account.

Response · in progress

{
    "data": {
        "jobId": "job_id_string",
        "state": "active",
        "message": "opening onlyfans.com",
        "progress": {
            "message": "opening onlyfans.com"
        },
        "email": "account_email_string",
        "returnvalue": null,
        "attemptsMade": 0,
        "timestamp": 1789931924202,
        "processedOn": 1789931924204
    }
}

Response · completed

{
    "data": {
        "jobId": "job_id_string",
        "state": "completed",
        "message": "account connected",
        "progress": {
            "message": "account connected"
        },
        "email": "account_email_string",
        "returnvalue": {
            "status": "completed",
            "result": {
                "status": "success",
                "result": {
                    "account": {
                        "id": 9,
                        "user_id": "user_id_string",
                        "email": "account_email_string",
                        "account_id": "account_id_string",
                        "name": "Account_Name",
                        "country_code": "US",
                        "created_at": "2026-09-20T21:03:01.510395",
                        "updated_at": "2026-09-20T21:03:01.510401"
                    }
                }
            }
        },
        "attemptsMade": 1,
        "timestamp": xxxxxxxxxxx,
        "processedOn": xxxxxxxxxxx,
        "finishedOn": xxxxxxxxxxx
    }
}