---
title: "Update subscription discount"
method: POST
path: "/api/v1.4/subscriptions/{subscription_id}/update_discount/"
tags: ["v1.1"]
---

# Update subscription discount

`POST /api/v1.4/subscriptions/{subscription_id}/update_discount/`

Update subscription discount

## Path parameters

- `subscription_id` string, required

## Request body

- UpdateSubscriptionDiscount
  - `discount_amount` string, decimal — Override Discount amount applied.
  - `discount_percentage` string, decimal — Override Discount percentage applied.
  - `discount_cycles` integer, required — Override How many cycles the discount will be applied to.

## Response `200`

- SubscriptionDetails
  - `id` string, required
  - `account` object, required
  - `plan` object, required — Plan ID subscription attached to.
  - `current_status` object, required — Subscription current status.
  - `statuses` unknown[], required — Subscription status history.
    - unknown
  - `start_date` string, date — Start date of subscription trial or subscription first cycle.
  - `customer` object, required — Customer UUID attached to the subscription.
  - `charge_automatically` boolean — Determine if the subscription invoice will be charged automatically using card token.
  - `primary_card_token` string, nullable, required
  - `remaining_recurring_cycles` integer, nullable — Number of remaining recurring cycles in the subscription life time, null if the subscription is forever.
  - `remaining_discount_cycles` integer, nullable — Number of recurring cycles to apply discount to, null if there is no discount.
  - `configuration` object, required — Subscription configuration attached to subscription.
  - `webhook_url` string, uri, nullable — A URL that the Moneyhash server will send a POST request to with subscription status updates.
  - `custom_fields` unknown
  - `due_invoices` object[], required — Due invoices to be paid.
  - `next_recurring_cycle_invoice` object, required — Start date of the next recurring cycle, null if the current date less than start date
  - `all_invoices` object, required — All invoices related to this subscription.
  - `is_live` boolean, required
  - `end_date` string, required
  - `created` string, date-time, required
  - `transactions` unknown[], required — All transactions created when invoices paid.
    - unknown
  - `scheduled_updates` unknown[], required — Subscription updates to be done.
    - unknown
  - `proration_credit_notes` unknown[], required — Credit notes from proration downgrades.
    - unknown
  - `payment_redirects` object, nullable, required — Payment redirect URLs from plan group level.
  - `flow` object, nullable, required — The data of the payment flow attached to the subscription if exists.
  - `card_tokenization_payment_intent` object, nullable, required — The subscription payment intent that is used for card tokenization when charge_automatically is true and primary_card_token is not provided in the subscription creation

## Other responses

- `400`
- `401`
- `404`

---

[API](https://skmtc.net/moneyhash/apis/moneyhash-api.md) · [All operations](https://skmtc.net/moneyhash/apis/moneyhash-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/moneyhash/moneyhash-api/versions/111e4c2e0826/schema)