coupon_code : Foxy hAPI

coupon_code

Description

Coupon codes are configured for each coupon you set up. They are unique codes to be used by your customers to obtain the coupon's discount.

If you would like to create multiple coupon codes at once, see the coupon documentation.

Interact with this resource

To interact with this resource and see it in the context of the API, you can utilise Postman or your Terminal/Console to perform requests. If you have a Foxy store, you can also use the API browser in the admin to interact with resources connected to your store.

Actions

GET: View a coupon_code
PATCH: Update a coupon_code (send only the properties you want to modify)
PUT: Replace a coupon_code (send the entire representation)
DELETE: Delete a coupon_code
HEAD: Get just the header response
OPTIONS: Get a response explaining which HTTP methods are supported

Properties

Property	Description	Type	Constraints
code	The string value of this coupon code which your customer will add to their cart to use this coupon.	String	Required. 50 characters or less.
number_of_uses_to_date	For informational purposes, this shows you how many times this coupon code has already been used.	Integer	Read Only
date_created	The date this resource was created.	Date	Read only
date_modified	The date this resource was last modified.	Date	Read only

Example Representation

{
    "_links": {
        "curies": [
            {
                "name": "fx",
                "href": "https://api.foxycart.com/rels/{rel}",
                "templated": true
            }
        ],
        "self": {
            "href": "https://api.foxycart.com/coupon_codes/6540",
            "title": "test"
        },
        "fx:store": {
            "href": "https://api.foxycart.com/stores/66",
            "title": "This Store"
        },
        "fx:coupon": {
            "href": "https://api.foxycart.com/coupons/244",
            "title": "This Coupon"
        },
        "fx:coupon_code_transactions": {
            "href": "https://api.foxycart.com/coupon_codes/6540/transactions",
            "title": "Transactions using this Coupon Code"
        }
    },
    "code": "test",
    "number_of_uses_to_date": 31,
    "date_created": null,
    "date_modified": null
}

<?xml version="1.0" encoding="UTF-8"?>
<resource href="https://api.foxycart.com/coupon_codes/6540" rel="https://api.foxycart.com/rels/coupon_code">
  <link rel="self" href="https://api.foxycart.com/coupon_codes/6540" title="test"/>
  <link rel="https://api.foxycart.com/rels/store" href="https://api.foxycart.com/stores/66" title="This Store"/>
  <link rel="https://api.foxycart.com/rels/coupon" href="https://api.foxycart.com/coupons/244" title="This Coupon"/>
  <link rel="https://api.foxycart.com/rels/coupon_code_transactions" href="https://api.foxycart.com/coupon_codes/6540/transactions" title="Transactions using this Coupon Code"/>
  <code>test</code>
  <number_of_uses_to_date>31</number_of_uses_to_date>
  <date_created></date_created>
  <date_modified></date_modified>
</resource>

{
    "class": [
        "coupon_code"
    ],
    "properties": {
        "code": "test",
        "number_of_uses_to_date": 31,
        "date_created": null,
        "date_modified": null
    },
    "links": [
        {
            "rel": [
                "self"
            ],
            "href": "https://api.foxycart.com/coupon_codes/6540"
        },
        {
            "rel": [
                "https://api.foxycart.com/rels/store"
            ],
            "href": "https://api.foxycart.com/stores/66"
        },
        {
            "rel": [
                "https://api.foxycart.com/rels/coupon"
            ],
            "href": "https://api.foxycart.com/coupons/244"
        },
        {
            "rel": [
                "https://api.foxycart.com/rels/coupon_code_transactions"
            ],
            "href": "https://api.foxycart.com/coupon_codes/6540/transactions"
        }
    ]
}

Zoomable Resources

This resource has no linked resources which can be "zoomed" in on, filtered and embedded within this resource.