API overview
For AI agents: the docs index is at /llms.txt, and every page is also served as markdown at its URL plus .md.
The TrialValid HTTP API: seller routes for pages, variants, trials, domains and alerts, public routes for the hosted trial page, and an OpenAPI document.
API keys are issued when your account is set up. Email hello@trialvalid.com to get one and the address of the API host.
The API sits on top of the trial engine. Seller methods take the authenticated account, another account's resource looks like a missing one, and public methods return no account, customer or Stripe ids.
What the API exposes
- Seller routes for trial pages, variants, trials, domains and alerts.
- Seller routes for your own TrialValid plan: start it with a Stripe Checkout link, open your Stripe billing page, end the trial early and read what you are billed for.
- Public routes for a published page and for starting a trial.
- A webhook route for Stripe events and a job route that runs due jobs about every minute.
- An OpenAPI document that describes every route, provided with your API access.
Every failure uses the envelope described in errors.