Skip to main content
GET
/
boxes
/
me
/
trial-eligibility
Get Trial Eligibility
const options = {method: 'GET', headers: {'X-Browser-Use-API-Key': '<api-key>'}};

fetch('https://api.browser-use.com/api/v3/boxes/me/trial-eligibility', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
{
  "eligible": true,
  "reason": "already_used",
  "message": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.browser-use.com/llms.txt

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

Authorizations

​
X-Browser-Use-API-Key
string
header
required

Response

Successful Response

GET /me/trial-eligibility — is this user eligible for a free trial?

Account-scoped — paid users see this too (one free trial per user, regardless of payment tier).

reason is a stable machine-readable code the FE branches on:

  • 'already_used' — user has already started a trial in their lifetime. Render an "upgrade to deploy" CTA.
  • 'no_owner' — couldn't resolve the project's owner profile (rare, older projects). FE falls back to generic "add credits" copy.
  • None when eligible=True.
​
eligible
boolean
required
​
reason
enum<string> | null
Available options:
already_used,
no_owner
​
message
string | null