> ## 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.

# Get Trial Eligibility

> Tell the FE whether to render a 'try free for 7 days' CTA.

Account-scoped — any user (free-tier or paid) without a prior
`bux_trial_started_at` stamp is eligible for one free 7-day trial.

Returns a tagged answer:
  - eligible=True   → show the trial CTA on the empty-state.
  - eligible=False, reason='already_used' → show "trial used,
    upgrade to deploy".
  - eligible=False, reason='no_owner' → fallback for older projects
    we can't resolve an owner for; FE shows generic "add credits".

Cheap call: one profile lookup. The FE polls /me + /sizes already,
this is one more cheap GET on the deploy page.



## OpenAPI

````yaml /cloud/openapi/v3.json get /boxes/me/trial-eligibility
openapi: 3.1.0
info:
  title: Browser Use Public API v3
  summary: Browser Use session-based agent API (v3)
  version: 3.0.0
servers:
  - url: https://api.browser-use.com/api/v3
    description: Production server
security: []
paths:
  /boxes/me/trial-eligibility:
    get:
      tags:
        - Boxes
      summary: Get Trial Eligibility
      description: |-
        Tell the FE whether to render a 'try free for 7 days' CTA.

        Account-scoped — any user (free-tier or paid) without a prior
        `bux_trial_started_at` stamp is eligible for one free 7-day trial.

        Returns a tagged answer:
          - eligible=True   → show the trial CTA on the empty-state.
          - eligible=False, reason='already_used' → show "trial used,
            upgrade to deploy".
          - eligible=False, reason='no_owner' → fallback for older projects
            we can't resolve an owner for; FE shows generic "add credits".

        Cheap call: one profile lookup. The FE polls /me + /sizes already,
        this is one more cheap GET on the deploy page.
      operationId: get_trial_eligibility_boxes_me_trial_eligibility_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TrialEligibilityView'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - APIKeyHeader: []
components:
  schemas:
    TrialEligibilityView:
      properties:
        eligible:
          type: boolean
          title: Eligible
        reason:
          anyOf:
            - type: string
              enum:
                - already_used
                - no_owner
            - type: 'null'
          title: Reason
        message:
          anyOf:
            - type: string
            - type: 'null'
          title: Message
      type: object
      required:
        - eligible
      title: TrialEligibilityView
      description: |-
        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.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: X-Browser-Use-API-Key

````