Skip to main content
DELETE
/
api
/
v2
/
subscriptions
/
{id}
Cancel subscription
curl --request DELETE \
  --url https://rcur.app/api/v2/subscriptions/{id} \
  --header 'Content-Type: application/json' \
  --data '
{
  "cancel_at": "2025-12-31"
}
'
{
  "id": "sub_abc123",
  "name": "Monthly Premium",
  "status": "active",
  "start_date": "2025-01-01",
  "created_at": "2025-01-01 10:00:00",
  "mollie_mandate_id": "mdt_abc123",
  "mollie_profile_id": "pfl_abc123",
  "next_payment_at": "2025-02-01",
  "next_amount": "29.99",
  "last_payment_created_at": "2025-01-01 10:00:00",
  "resume_at": "2025-03-01",
  "cancel_at": "2025-12-31",
  "rules": [
    {
      "id": "rule_abc123",
      "amount": "29.99",
      "currency": "EUR",
      "interval": "month",
      "interval_amount": 1,
      "day": 1,
      "times_done": 3,
      "times": 12
    }
  ],
  "customer": {}
}

Body

application/json

Cancellation data

​
cancel_at
string

Date to cancel at (Y-m-d). If omitted or in the past, cancels immediately.

Example:

"2025-12-31"

Response

Subscription details

​
id
string
required
Example:

"sub_abc123"

​
name
string
required
Example:

"Monthly Premium"

​
status
enum<string>
required
Available options:
draft,
active,
paused,
cancelled,
completed
Example:

"active"

​
start_date
string
required
Example:

"2025-01-01"

​
created_at
string
required
Example:

"2025-01-01 10:00:00"

​
mollie_mandate_id
string
Example:

"mdt_abc123"

​
mollie_profile_id
string
Example:

"pfl_abc123"

​
next_payment_at
string | null
Example:

"2025-02-01"

​
next_amount
string | null
Example:

"29.99"

​
last_payment_created_at
string | null
Example:

"2025-01-01 10:00:00"

​
resume_at
string | null
Example:

"2025-03-01"

​
cancel_at
string | null
Example:

"2025-12-31"

​
rules
object[]
​
customer
object