# Subscription Manager

## Docs

- [Duplicate subscriptions](https://docs.sub.jerrylu.app/api-reference/analytics/duplicate-subscriptions.md): Returns groups of non-cancelled subscriptions that share a normalized name, indicating likely duplicate tracking or double billing.
- [Optimization candidates](https://docs.sub.jerrylu.app/api-reference/analytics/optimization-candidates.md): Returns factual optimization candidates - active monthly subscriptions with their current annualized cost, and subscriptions whose monthly cost exceeds twice the per-currency average. No discount rates are invented.
- [Spend summary](https://docs.sub.jerrylu.app/api-reference/analytics/spend-summary.md): Returns subscription counts by status, monthly and yearly totals grouped per currency (never converted across currencies), spend by category, and upcoming renewals within a horizon.
- [List audit log](https://docs.sub.jerrylu.app/api-reference/audit/list-audit-log.md): Returns the audit trail of write operations performed through the API, newest first, with before/after state in metadata.
- [Create a subscription](https://docs.sub.jerrylu.app/api-reference/subscriptions/create.md): Creates a subscription for the authenticated API key owner. Server-managed fields are rejected if supplied.
- [Delete a subscription](https://docs.sub.jerrylu.app/api-reference/subscriptions/delete.md): Deletes one subscription if it belongs to the authenticated API key owner.
- [Get a subscription](https://docs.sub.jerrylu.app/api-reference/subscriptions/get.md): Returns one subscription if it belongs to the authenticated API key owner.
- [List subscriptions](https://docs.sub.jerrylu.app/api-reference/subscriptions/list.md): Returns subscriptions owned by the authenticated API key owner, newest first. Use the limit and offset query parameters to page through results.
- [Preflight subscriptions collection](https://docs.sub.jerrylu.app/api-reference/subscriptions/options.md): Returns CORS headers for browser preflight requests.
- [Preflight subscription item](https://docs.sub.jerrylu.app/api-reference/subscriptions/options-item.md): Returns CORS headers for browser preflight requests.
- [Update a subscription](https://docs.sub.jerrylu.app/api-reference/subscriptions/update.md): Updates a non-empty subset of writable fields. Only the supplied fields are validated. nextPaymentDate is recalculated only when lastPaymentDate, period, or customDate changes; otherwise the stored value is kept.
- [Deploy this documentation site](https://docs.sub.jerrylu.app/en/advanced/mintlify-deployment.md): Use Mintlify to preview and publish the docs-site directory.
- [AI tool usage](https://docs.sub.jerrylu.app/en/api/ai-tools.md): Use the public API as AI agent tools with operation semantics, confirmation rules, and recovery guidance.
- [Analytics](https://docs.sub.jerrylu.app/en/api/analytics.md): Computed spend summaries, duplicate detection, and optimization candidates for AI agents.
- [Audit log](https://docs.sub.jerrylu.app/en/api/audit.md): Read the audit trail of write operations performed through the public API.
- [Authentication](https://docs.sub.jerrylu.app/en/api/authentication.md): Create Developer API keys and authenticate public API requests with Bearer tokens.
- [Errors and limits](https://docs.sub.jerrylu.app/en/api/errors-and-limits.md): Understand error responses, request IDs, rate-limit headers, and CORS behavior.
- [Public API overview](https://docs.sub.jerrylu.app/en/api/overview.md): Use Developer API keys to automate subscription lifecycle, analytics, and audit access through the v1 public API.
- [Subscription CRUD](https://docs.sub.jerrylu.app/en/api/subscriptions.md): Create, read, update, and delete subscriptions with task semantics for AI agents.
- [Configuration](https://docs.sub.jerrylu.app/en/configuration.md): Environment variables and feature flags for local-first, hosted, payment, notification, and public API deployments.
- [Deployment](https://docs.sub.jerrylu.app/en/deployment.md): Deploy the Vite frontend, Netlify Functions, Supabase migrations, Stripe webhooks, and scheduled jobs.
- [Getting started](https://docs.sub.jerrylu.app/en/getting-started.md): Run Subscription Manager locally and understand the default local-first behavior.
- [Introduction](https://docs.sub.jerrylu.app/en/index.md): Subscription Manager is a local-first app for tracking recurring subscriptions, optional cloud sync, payments, reminders, and API automation.
- [AI capture](https://docs.sub.jerrylu.app/en/integrations/ai-capture.md): Configure AI-assisted subscription capture for text, screenshots, creates, updates, deletes, quotas, and privacy.
- [Renewal reminders with Bark](https://docs.sub.jerrylu.app/en/integrations/notifications.md): Configure scheduled Bark push notifications for upcoming subscription renewals.
- [Payments with Stripe](https://docs.sub.jerrylu.app/en/integrations/payments.md): Configure Stripe Checkout and webhooks for premium activation.
- [Cloud sync with Supabase](https://docs.sub.jerrylu.app/en/integrations/supabase.md): Configure Supabase for authentication, cloud sync, user profiles, notification settings, payments, API keys, and AI capture quotas.
- [Account and sync](https://docs.sub.jerrylu.app/en/user-guide/account-sync.md): Understand local data, sign-in, cloud sync, and account settings.
- [AI capture](https://docs.sub.jerrylu.app/en/user-guide/ai-capture.md): Use natural language or screenshots to propose subscription changes.
- [Categories](https://docs.sub.jerrylu.app/en/user-guide/categories.md): Organize subscriptions with built-in and custom categories.
- [Currencies](https://docs.sub.jerrylu.app/en/user-guide/currencies.md): Understand base currency, exchange rates, monthly totals, and yearly totals.
- [Developer API keys](https://docs.sub.jerrylu.app/en/user-guide/developer-api-keys.md): Create and revoke API keys for trusted scripts, agents, and automations.
- [FAQ](https://docs.sub.jerrylu.app/en/user-guide/faq.md): Common user questions about storage, sync, AI capture, reminders, currencies, and backups.
- [Import and export](https://docs.sub.jerrylu.app/en/user-guide/import-export.md): Back up, restore, and move subscription data with JSON files.
- [User guide](https://docs.sub.jerrylu.app/en/user-guide/overview.md): Learn how to use Subscription Manager to track renewals, spending, reminders, AI capture, and backups.
- [Reminders](https://docs.sub.jerrylu.app/en/user-guide/reminders.md): Set up Bark renewal reminders and per-subscription notification toggles.
- [Subscriptions](https://docs.sub.jerrylu.app/en/user-guide/subscriptions.md): Add, edit, filter, sort, and delete subscription records.

## OpenAPI Specs

- [openapi](https://docs.sub.jerrylu.app/api/openapi.yaml)