Skip to main content

Subscriptions API

List Subscriptions

GET /api/subscriptions?page=1&status=ACTIVE&search=consulting

Get Subscription

GET /api/subscriptions/:id

Detect Subscriptions

POST /api/subscriptions/detect
{
  "merchantIds": ["clx..."],
  "minTransactions": 2,
  "matchDescription": true,
  "includeTerms": ["Consulting Services", "Monthly Retainer"],
  "excludeTerms": ["setup fee", "one-time"],
  "removeExisting": false
}
Triggers subscription detection from transaction patterns. Returns count of detected subscriptions.

Remove Detected Subscription

POST /api/subscriptions/:id/dismiss
Removes a detected subscription (sets status to DISMISSED). Transactions remain linked.