Skip to main content
GET
/
v1
/
subscription
curl https://api.v2.dealmachine.com/v1/subscription \
  -H "Authorization: Bearer dm_sk_live_xxx"

{
  "status": "active",
  "plan": {
    "name": "Starter",
    "is_paid": true
  },
  "trial": {
    "is_trialing": false,
    "trial_end": null,
    "enrichment_credits": 0
  },
  "billing_cycle": {
    "start": "2026-04-01T00:00:00.000Z",
    "end": "2026-05-01T00:00:00.000Z"
  },
  "credits": {
    "enrichment_cap": 10000,
    "ai_cap": 25000000
  }
}
Get your current subscription status, including plan details, billing cycle, and credit caps. Use this endpoint to check your billing status and what credits are available.
Subscription lifecycle: 1. After signup, status is none — no enrichment credits available. 2. After checkout, status is active — full plan credits.
curl https://api.v2.dealmachine.com/v1/subscription \
  -H "Authorization: Bearer dm_sk_live_xxx"

{
  "status": "active",
  "plan": {
    "name": "Starter",
    "is_paid": true
  },
  "trial": {
    "is_trialing": false,
    "trial_end": null,
    "enrichment_credits": 0
  },
  "billing_cycle": {
    "start": "2026-04-01T00:00:00.000Z",
    "end": "2026-05-01T00:00:00.000Z"
  },
  "credits": {
    "enrichment_cap": 10000,
    "ai_cap": 25000000
  }
}

​
Response Fields

FieldTypeDescription
statusstringSubscription status: none, trialing, active, past_due, canceled, incomplete, unpaid, paused
plan.namestringPlan name (e.g., “Starter”, “Pro”, “No plan”)
plan.is_paidbooleantrue if the subscription is active and paid
trial.is_trialingbooleantrue only for legacy Stripe subscriptions still in pre-billing status
trial.trial_endstring | nullISO 8601 timestamp when that status ends (null otherwise)
trial.enrichment_creditsnumberEnrichment credits available in that status (0 otherwise)
billing_cycle.startstringISO 8601 start of the current billing cycle
billing_cycle.endstringISO 8601 end of the current billing cycle
credits.enrichment_capnumberMax enrichment credits for this billing cycle
credits.ai_capnumberMax AI credits (tokens) for this billing cycle

​
Status Values

StatusMeaningCan use API?
noneNo subscription — just signed upNo (403)
trialingLegacy pre-billing statusYes
activePaid subscriptionYes
past_duePayment failed, grace periodYes (limited)
canceledSubscription canceledNo