WooCommerce · Schema

CouponInput

Input for creating or updating a coupon.

eCommerceOpen SourceOrdersProductsWordPress

Properties

Name	Type	Description
code	string	Coupon code (required for create).
amount	string	Discount amount as a decimal string.
discount_type	string	Discount type.
description	string	Admin description.
date_expires	string	Expiry date.
individual_use	boolean	Whether usable alone.
product_ids	array	Applicable product IDs.
excluded_product_ids	array	Excluded product IDs.
usage_limit	integer	Total usage limit.
usage_limit_per_user	integer	Per-customer usage limit.
minimum_amount	string	Minimum order amount.
maximum_amount	string	Maximum order amount.
meta_data	array	Custom metadata.

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/woocommerce/refs/heads/main/json-schema/woocommerce-rest-api-coupon-input-schema.json",
  "title": "CouponInput",
  "description": "Input for creating or updating a coupon.",
  "type": "object",
  "properties": {
    "code": {
      "type": "string",
      "description": "Coupon code (required for create).",
      "example": "string-value"
    },
    "amount": {
      "type": "string",
      "description": "Discount amount as a decimal string.",
      "example": "string-value"
    },
    "discount_type": {
      "type": "string",
      "description": "Discount type.",
      "enum": [
        "percent",
        "fixed_cart",
        "fixed_product"
      ],
      "example": "percent"
    },
    "description": {
      "type": "string",
      "description": "Admin description.",
      "example": "A sample description"
    },
    "date_expires": {
      "type": "string",
      "format": "date-time",
      "description": "Expiry date.",
      "example": "2026-05-03T14:30:00Z"
    },
    "individual_use": {
      "type": "boolean",
      "description": "Whether usable alone.",
      "example": true
    },
    "product_ids": {
      "type": "array",
      "description": "Applicable product IDs.",
      "items": {
        "type": "integer"
      },
      "example": [
        1
      ]
    },
    "excluded_product_ids": {
      "type": "array",
      "description": "Excluded product IDs.",
      "items": {
        "type": "integer"
      },
      "example": [
        1
      ]
    },
    "usage_limit": {
      "type": "integer",
      "description": "Total usage limit.",
      "example": 1
    },
    "usage_limit_per_user": {
      "type": "integer",
      "description": "Per-customer usage limit.",
      "example": 1
    },
    "minimum_amount": {
      "type": "string",
      "description": "Minimum order amount.",
      "example": "string-value"
    },
    "maximum_amount": {
      "type": "string",
      "description": "Maximum order amount.",
      "example": "string-value"
    },
    "meta_data": {
      "type": "array",
      "description": "Custom metadata.",
      "items": {
        "type": "object",
        "description": "Custom metadata key-value entry.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Metadata unique identifier.",
            "example": 1
          },
          "key": {
            "type": "string",
            "description": "Metadata key.",
            "example": "string-value"
          },
          "value": {
            "type": "string",
            "description": "Metadata value.",
            "example": "string-value"
          }
        }
      },
      "example": [
        "string-value"
      ]
    }
  }
}