title: Discount
description: Represents a discount that can be applied to a cart for promotional purposes.
type: object
required:
  - code
  - created_at
  - deleted_at
  - ends_at
  - id
  - is_disabled
  - is_dynamic
  - metadata
  - parent_discount_id
  - rule_id
  - starts_at
  - updated_at
  - usage_count
  - usage_limit
  - valid_duration
properties:
  id:
    description: The discount's ID
    type: string
    example: disc_01F0YESMW10MGHWJKZSDDMN0VN
  code:
    description: >-
      A unique code for the discount - this will be used by the customer to
      apply the discount
    type: string
    example: 10DISC
  is_dynamic:
    description: >-
      A flag to indicate if multiple instances of the discount can be generated.
      I.e. for newsletter discounts
    type: boolean
    example: false
  rule_id:
    description: The Discount Rule that governs the behaviour of the Discount
    nullable: true
    type: string
    example: dru_01F0YESMVK96HVX7N419E3CJ7C
  rule:
    description: Available if the relation `rule` is expanded.
    nullable: true
    $ref: ./DiscountRule.yaml
  is_disabled:
    description: >-
      Whether the Discount has been disabled. Disabled discounts cannot be
      applied to carts
    type: boolean
    example: false
  parent_discount_id:
    description: >-
      The Discount that the discount was created from. This will always be a
      dynamic discount
    nullable: true
    type: string
    example: disc_01G8ZH853YPY9B94857DY91YGW
  parent_discount:
    description: Available if the relation `parent_discount` is expanded.
    nullable: true
    type: object
  starts_at:
    description: The time at which the discount can be used.
    type: string
    format: date-time
  ends_at:
    description: The time at which the discount can no longer be used.
    nullable: true
    type: string
    format: date-time
  valid_duration:
    description: Duration the discount runs between
    nullable: true
    type: string
    example: P3Y6M4DT12H30M5S
  regions:
    description: >-
      The Regions in which the Discount can be used. Available if the relation
      `regions` is expanded.
    type: array
    items:
      $ref: ./Region.yaml
  usage_limit:
    description: The maximum number of times that a discount can be used.
    nullable: true
    type: integer
    example: 100
  usage_count:
    description: The number of times a discount has been used.
    type: integer
    example: 50
    default: 0
  created_at:
    description: The date with timezone at which the resource was created.
    type: string
    format: date-time
  updated_at:
    description: The date with timezone at which the resource was updated.
    type: string
    format: date-time
  deleted_at:
    description: The date with timezone at which the resource was deleted.
    nullable: true
    type: string
    format: date-time
  metadata:
    description: An optional key-value map with additional details
    nullable: true
    type: object
    example:
      car: white