Skip to main content

Trial API

Check the free trial status for the authenticated user. New accounts receive a 7-day free trial automatically on sign-up.

Get trial status

Returns the current trial state for the authenticated user. When no session is present, returns { trial: false } without an error.

Response (active trial)

When the user has an active trial that has not expired:

Response (expired trial)

When the trial period has ended and the user has not upgraded:

Response (paid user)

When the user has an active subscription or a non-free plan:

Response (no trial)

When the user has no trial configured (legacy accounts or accounts without a trial end date):

Response (unauthenticated)

When no valid session is present:
This endpoint does not return a 401 error for unauthenticated requests. It returns { trial: false } instead, allowing the client to render a default state without handling authentication errors.