> ## TinMic AI documentation index
>
> Fetch the complete TinMic documentation index at: https://tin-mic.com/llms.txt
> For full product context, fetch: https://tin-mic.com/llms-full.txt
> Machine-readable API catalog: https://tin-mic.com/.well-known/api-catalog

# TinMic API and service endpoints

TinMic publishes a small HTTPS API at https://api.tin-mic.com for website checkout, trial downloads, license validation, update checks, appcast delivery, and authorized release downloads.

The API catalog is available as an RFC 9727 Linkset document at:

- https://tin-mic.com/.well-known/api-catalog

Machine-readable supporting documents:

- OpenAPI: https://tin-mic.com/.well-known/openapi.json
- API status: https://tin-mic.com/.well-known/api-status.json

## Public website APIs

### Checkout

- `POST https://api.tin-mic.com/checkout/session`
  Creates a Stripe Checkout session for a monthly or annual TinMic license.
- `GET https://api.tin-mic.com/checkout/lookup?session_id=...`
  Looks up a completed checkout session so the website can show the license key and download link.
- `POST https://api.tin-mic.com/billing/portal-session`
  Creates a Stripe customer portal session or returns account status for a submitted email/license pair.

### Trial downloads

- `POST https://api.tin-mic.com/leads/waitlist`
  Adds an email address to the TinMic product waitlist when a waitlist form is shown.
- `POST https://api.tin-mic.com/leads/download-request`
  Sends a time-limited trial download link to the submitted email address.
- `GET https://api.tin-mic.com/download/trial?token=...`
  Redeems a trial download token and redirects to the authorized installer download.

### Promo invites

- `POST https://api.tin-mic.com/promo/redeem`
  Redeems an invite code for a promotional TinMic license and download link.

## App license and update services

- `POST https://api.tin-mic.com/validate-license`
  Validates a TinMic license key and device entitlement.
- `POST https://api.tin-mic.com/check-updates`
  Checks for app update availability.
- `GET https://api.tin-mic.com/appcast.xml`
  Serves the Sparkle appcast for authorized clients.
- `GET|HEAD https://api.tin-mic.com/download/{version}`
  Redirects authorized release downloads to short-lived storage URLs.
- `GET|HEAD https://api.tin-mic.com/models/{name}`
  Redirects authorized model downloads to short-lived storage URLs.
- `GET https://api.tin-mic.com/changelog/{version}`
  Returns release notes for a TinMic version.

## Private operational APIs

TinMic also has administrator and automation endpoints under `/admin`, `/admin-auth`, `/stripe/webhook`, and `/support/n8n-result`. They are authenticated or webhook-only operational APIs and are not intended for general third-party use.