Coupons

Fetches all coupons for a store id

get

Authorizations

APIKey

AuthorizationstringRequired

An API Key token generated in the Dashboard in the format 'APIKey TOKEN_HERE'.

Path parameters

storeIdstring · flake-idRequiredExample: 411486491630370816

Query parameters

limitinteger · int32 · min: 1 · max: 100Optional

The maximum number of items to return in a single request.

afterstring · flake-idOptional

Returns items after the specified ID. Used for forward pagination through results.

Example: 411486491630370816

beforestring · flake-idOptional

Returns items before the specified ID. Used for backward pagination through results.

Example: 411486491630370816

ascbooleanOptional

Determines the sort order of returned items. When true, items are returned in ascending order. When false, items are returned in descending order.

statusstring · enumOptional

Will filter by coupon status.

Possible values:

typestring · enumOptional

Will filter by coupon creation type.

Possible values:

Responses

200

OK

application/json

Represents a detailed view of a coupon, including configuration and audit information.

idstring · flake-idRequiredExample: 411486491630370816

store_idstring · flake-idRequiredExample: 411486491630370816

enabledbooleanRequired

Indicates whether the coupon is enabled.

codestringRequired

The unique code associated with the coupon.

notestring · nullableOptional

A note or internal description of the coupon.

durationstring · enumRequired

Defines the duration for which a coupon remains valid.

Possible values:

duration_in_monthsinteger · nullableOptional

The number of months the coupon is valid, used if the duration is repeating.

discount_typestring · enumRequired

Specifies the type of discount applied by a coupon.

Possible values:

discount_amountinteger · int64Required

The discount amount in the smallest currency unit (e.g., cents).

discount_apply_individuallybooleanRequired

Indicates whether the discount should be applied individually to required tags or products.

discount_apply_before_salesbooleanRequired

Indicates whether the discount is applied before existing sales.

apply_to_productsstring · flake-id[] · nullableOptional

A list of product IDs the coupon applies to.

Example: 411486491630370816

apply_to_tagsstring · flake-id[] · nullableOptional

A list of tag IDs the coupon applies to.

Example: 411486491630370816

usable_by_customer_idstring · flake-idOptionalExample: 411486491630370816

minimum_order_valueinteger · int64Required

The minimum order value required to use the coupon.

redeem_limit_store_enabledbooleanRequired

Indicates whether a global redemption limit is enabled.

redeem_limit_store_amountinteger · int64Required

The maximum number of times the coupon can be redeemed across the store.

redeem_limit_customer_enabledbooleanRequired

Indicates whether a per-customer redemption limit is enabled.

redeem_limit_customer_amountinteger · int64Required

The maximum number of times the coupon can be redeemed per customer.

usable_on_one_time_purchasebooleanRequired

Indicates whether the coupon can be used for one-time purchases.

usable_on_subscriptionbooleanRequired

Indicates whether the coupon can be used for subscriptions.

usable_atstring · nullableOptional

The date and time when the coupon becomes valid.

expires_atstring · nullableOptional

The date and time when the coupon expires.

created_atstring · date-timeRequired

The date and time when the coupon was created.

updated_atstring · nullableOptional

The date and time when the coupon was last updated.

default

Error response

application/json

get

/v1/stores/{storeId}/coupons

HTTPcURLJavaScriptPython

GET /v1/stores/{storeId}/coupons HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*

[
  {
    "id": "411486491630370816",
    "store_id": "411486491630370816",
    "enabled": true,
    "code": "text",
    "note": null,
    "duration": "once",
    "duration_in_months": null,
    "discount_type": "unspecified",
    "discount_amount": 1,
    "discount_apply_individually": true,
    "discount_apply_before_sales": true,
    "apply_to_products": [
      "411486491630370816"
    ],
    "apply_to_tags": [
      "411486491630370816"
    ],
    "usable_by_customer_id": "411486491630370816",
    "minimum_order_value": 1,
    "redeem_limit_store_enabled": true,
    "redeem_limit_store_amount": 1,
    "redeem_limit_customer_enabled": true,
    "redeem_limit_customer_amount": 1,
    "usable_on_one_time_purchase": true,
    "usable_on_subscription": true,
    "usable_at": null,
    "expires_at": null,
    "created_by": {
      "type": "anonymous",
      "id": "411486491630370816"
    },
    "created_at": "2026-02-18T23:00:35.071Z",
    "updated_by": {
      "type": "anonymous",
      "id": "411486491630370816"
    },
    "updated_at": null
  }
]

post

Authorizations

APIKey

AuthorizationstringRequired

An API Key token generated in the Dashboard in the format 'APIKey TOKEN_HERE'.

Path parameters

storeIdstring · flake-idRequiredExample: 411486491630370816

Body

application/jsontext/jsonapplication/*+json

enabledbooleanRequired

codestringRequired

notestringOptional

durationstring · enumRequired

Defines the duration for which a coupon remains valid.

Possible values:

duration_in_monthsinteger · nullableOptional

discount_typestring · enumRequired

Specifies the type of discount applied by a coupon.

Possible values:

discount_amountinteger · int64Required

discount_apply_individuallybooleanRequired

discount_apply_before_salesbooleanRequired

apply_to_productsstring · flake-id[]OptionalExample: 411486491630370816

apply_to_tagsstring · flake-id[]OptionalExample: 411486491630370816

usable_by_customer_idstring · flake-idOptionalExample: 411486491630370816

minimum_order_valueinteger · int64Required

redeem_limit_store_enabledbooleanRequired

redeem_limit_store_amountinteger · int64Required

redeem_limit_customer_enabledbooleanRequired

redeem_limit_customer_amountinteger · int64Required

usable_on_one_time_purchasebooleanRequired

usable_on_subscriptionbooleanRequired

usable_atstring · nullableOptional

expires_atstring · nullableOptional

Responses

200

OK

application/json

Represents a detailed view of a coupon, including configuration and audit information.

idstring · flake-idRequiredExample: 411486491630370816

store_idstring · flake-idRequiredExample: 411486491630370816

enabledbooleanRequired

Indicates whether the coupon is enabled.

codestringRequired

The unique code associated with the coupon.

notestring · nullableOptional

A note or internal description of the coupon.

durationstring · enumRequired

Defines the duration for which a coupon remains valid.

Possible values:

duration_in_monthsinteger · nullableOptional

The number of months the coupon is valid, used if the duration is repeating.

discount_typestring · enumRequired

Specifies the type of discount applied by a coupon.

Possible values:

discount_amountinteger · int64Required

The discount amount in the smallest currency unit (e.g., cents).

discount_apply_individuallybooleanRequired

Indicates whether the discount should be applied individually to required tags or products.

discount_apply_before_salesbooleanRequired

Indicates whether the discount is applied before existing sales.

apply_to_productsstring · flake-id[] · nullableOptional

A list of product IDs the coupon applies to.

Example: 411486491630370816

apply_to_tagsstring · flake-id[] · nullableOptional

A list of tag IDs the coupon applies to.

Example: 411486491630370816

usable_by_customer_idstring · flake-idOptionalExample: 411486491630370816

minimum_order_valueinteger · int64Required

The minimum order value required to use the coupon.

redeem_limit_store_enabledbooleanRequired

Indicates whether a global redemption limit is enabled.

redeem_limit_store_amountinteger · int64Required

The maximum number of times the coupon can be redeemed across the store.

redeem_limit_customer_enabledbooleanRequired

Indicates whether a per-customer redemption limit is enabled.

redeem_limit_customer_amountinteger · int64Required

The maximum number of times the coupon can be redeemed per customer.

usable_on_one_time_purchasebooleanRequired

Indicates whether the coupon can be used for one-time purchases.

usable_on_subscriptionbooleanRequired

Indicates whether the coupon can be used for subscriptions.

usable_atstring · nullableOptional

The date and time when the coupon becomes valid.

expires_atstring · nullableOptional

The date and time when the coupon expires.

created_atstring · date-timeRequired

The date and time when the coupon was created.

updated_atstring · nullableOptional

The date and time when the coupon was last updated.

default

Error response

application/json

post

/v1/stores/{storeId}/coupons

HTTPcURLJavaScriptPython

POST /v1/stores/{storeId}/coupons HTTP/1.1
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 593

{
  "enabled": true,
  "code": "text",
  "note": "text",
  "duration": "once",
  "duration_in_months": null,
  "discount_type": "unspecified",
  "discount_amount": 1,
  "discount_apply_individually": true,
  "discount_apply_before_sales": true,
  "apply_to_products": [
    "411486491630370816"
  ],
  "apply_to_tags": [
    "411486491630370816"
  ],
  "usable_by_customer_id": "411486491630370816",
  "minimum_order_value": 1,
  "redeem_limit_store_enabled": true,
  "redeem_limit_store_amount": 1,
  "redeem_limit_customer_enabled": true,
  "redeem_limit_customer_amount": 1,
  "usable_on_one_time_purchase": true,
  "usable_on_subscription": true,
  "usable_at": null,
  "expires_at": null
}

application/jsontext/jsonapplication/*+json

{
  "id": "411486491630370816",
  "store_id": "411486491630370816",
  "enabled": true,
  "code": "text",
  "note": null,
  "duration": "once",
  "duration_in_months": null,
  "discount_type": "unspecified",
  "discount_amount": 1,
  "discount_apply_individually": true,
  "discount_apply_before_sales": true,
  "apply_to_products": [
    "411486491630370816"
  ],
  "apply_to_tags": [
    "411486491630370816"
  ],
  "usable_by_customer_id": "411486491630370816",
  "minimum_order_value": 1,
  "redeem_limit_store_enabled": true,
  "redeem_limit_store_amount": 1,
  "redeem_limit_customer_enabled": true,
  "redeem_limit_customer_amount": 1,
  "usable_on_one_time_purchase": true,
  "usable_on_subscription": true,
  "usable_at": null,
  "expires_at": null,
  "created_by": {
    "type": "anonymous",
    "id": "411486491630370816"
  },
  "created_at": "2026-02-18T23:00:35.071Z",
  "updated_by": {
    "type": "anonymous",
    "id": "411486491630370816"
  },
  "updated_at": null
}

Retrieves a coupon by ID

get

Authorizations

APIKey

AuthorizationstringRequired

An API Key token generated in the Dashboard in the format 'APIKey TOKEN_HERE'.

Path parameters

storeIdstring · flake-idRequiredExample: 411486491630370816

couponIdstring · flake-idRequiredExample: 411486491630370816

Responses

200

OK

application/json

Represents a detailed view of a coupon, including configuration and audit information.

idstring · flake-idRequiredExample: 411486491630370816

store_idstring · flake-idRequiredExample: 411486491630370816

enabledbooleanRequired

Indicates whether the coupon is enabled.

codestringRequired

The unique code associated with the coupon.

notestring · nullableOptional

A note or internal description of the coupon.

durationstring · enumRequired

Defines the duration for which a coupon remains valid.

Possible values:

duration_in_monthsinteger · nullableOptional

The number of months the coupon is valid, used if the duration is repeating.

discount_typestring · enumRequired

Specifies the type of discount applied by a coupon.

Possible values:

discount_amountinteger · int64Required

The discount amount in the smallest currency unit (e.g., cents).

discount_apply_individuallybooleanRequired

Indicates whether the discount should be applied individually to required tags or products.

discount_apply_before_salesbooleanRequired

Indicates whether the discount is applied before existing sales.

apply_to_productsstring · flake-id[] · nullableOptional

A list of product IDs the coupon applies to.

Example: 411486491630370816

apply_to_tagsstring · flake-id[] · nullableOptional

A list of tag IDs the coupon applies to.

Example: 411486491630370816

usable_by_customer_idstring · flake-idOptionalExample: 411486491630370816

minimum_order_valueinteger · int64Required

The minimum order value required to use the coupon.

redeem_limit_store_enabledbooleanRequired

Indicates whether a global redemption limit is enabled.

redeem_limit_store_amountinteger · int64Required

The maximum number of times the coupon can be redeemed across the store.

redeem_limit_customer_enabledbooleanRequired

Indicates whether a per-customer redemption limit is enabled.

redeem_limit_customer_amountinteger · int64Required

The maximum number of times the coupon can be redeemed per customer.

usable_on_one_time_purchasebooleanRequired

Indicates whether the coupon can be used for one-time purchases.

usable_on_subscriptionbooleanRequired

Indicates whether the coupon can be used for subscriptions.

usable_atstring · nullableOptional

The date and time when the coupon becomes valid.

expires_atstring · nullableOptional

The date and time when the coupon expires.

created_atstring · date-timeRequired

The date and time when the coupon was created.

updated_atstring · nullableOptional

The date and time when the coupon was last updated.

404

Not Found

application/json

default

Error response

application/json

get

/v1/stores/{storeId}/coupons/{couponId}

HTTPcURLJavaScriptPython

GET /v1/stores/{storeId}/coupons/{couponId} HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*

{
  "id": "411486491630370816",
  "store_id": "411486491630370816",
  "enabled": true,
  "code": "text",
  "note": null,
  "duration": "once",
  "duration_in_months": null,
  "discount_type": "unspecified",
  "discount_amount": 1,
  "discount_apply_individually": true,
  "discount_apply_before_sales": true,
  "apply_to_products": [
    "411486491630370816"
  ],
  "apply_to_tags": [
    "411486491630370816"
  ],
  "usable_by_customer_id": "411486491630370816",
  "minimum_order_value": 1,
  "redeem_limit_store_enabled": true,
  "redeem_limit_store_amount": 1,
  "redeem_limit_customer_enabled": true,
  "redeem_limit_customer_amount": 1,
  "usable_on_one_time_purchase": true,
  "usable_on_subscription": true,
  "usable_at": null,
  "expires_at": null,
  "created_by": {
    "type": "anonymous",
    "id": "411486491630370816"
  },
  "created_at": "2026-02-18T23:00:35.071Z",
  "updated_by": {
    "type": "anonymous",
    "id": "411486491630370816"
  },
  "updated_at": null
}

Deletes a coupon

delete

Authorizations

APIKey

AuthorizationstringRequired

An API Key token generated in the Dashboard in the format 'APIKey TOKEN_HERE'.

Path parameters

storeIdstring · flake-idRequiredExample: 411486491630370816

couponIdstring · flake-idRequiredExample: 411486491630370816

Responses

204

No Content

default

Error response

application/json

delete

/v1/stores/{storeId}/coupons/{couponId}

HTTPcURLJavaScriptPython

DELETE /v1/stores/{storeId}/coupons/{couponId} HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*

No content

Performs a Delta Update of a Coupon

patch

Authorizations

APIKey

AuthorizationstringRequired

An API Key token generated in the Dashboard in the format 'APIKey TOKEN_HERE'.

Path parameters

storeIdstring · flake-idRequiredExample: 411486491630370816

couponIdstring · flake-idRequiredExample: 411486491630370816

Body

application/jsontext/jsonapplication/*+json

enabledbooleanOptional

codestringOptional

notestringOptional

durationstring · enumOptional

Defines the duration for which a coupon remains valid.

Possible values:

duration_in_monthsinteger · nullableOptional

discount_typestring · enumOptional

Specifies the type of discount applied by a coupon.

Possible values:

discount_amountinteger · int64Optional

discount_apply_individuallybooleanOptional

discount_apply_before_salesbooleanOptional

apply_to_productsstring · flake-id[]OptionalExample: 411486491630370816

apply_to_tagsstring · flake-id[]OptionalExample: 411486491630370816

usable_by_customer_idstring · flake-idOptionalExample: 411486491630370816

minimum_order_valueinteger · int64Optional

redeem_limit_store_enabledbooleanOptional

redeem_limit_store_amountinteger · int64Optional

redeem_limit_customer_enabledbooleanOptional

redeem_limit_customer_amountinteger · int64Optional

usable_on_one_time_purchasebooleanOptional

usable_on_subscriptionbooleanOptional

usable_atstring · nullableOptional

expires_atstring · nullableOptional

Responses

200

OK

application/json

Represents a detailed view of a coupon, including configuration and audit information.

idstring · flake-idRequiredExample: 411486491630370816

store_idstring · flake-idRequiredExample: 411486491630370816

enabledbooleanRequired

Indicates whether the coupon is enabled.

codestringRequired

The unique code associated with the coupon.

notestring · nullableOptional

A note or internal description of the coupon.

durationstring · enumRequired

Defines the duration for which a coupon remains valid.

Possible values:

duration_in_monthsinteger · nullableOptional

The number of months the coupon is valid, used if the duration is repeating.

discount_typestring · enumRequired

Specifies the type of discount applied by a coupon.

Possible values:

discount_amountinteger · int64Required

The discount amount in the smallest currency unit (e.g., cents).

discount_apply_individuallybooleanRequired

Indicates whether the discount should be applied individually to required tags or products.

discount_apply_before_salesbooleanRequired

Indicates whether the discount is applied before existing sales.

apply_to_productsstring · flake-id[] · nullableOptional

A list of product IDs the coupon applies to.

Example: 411486491630370816

apply_to_tagsstring · flake-id[] · nullableOptional

A list of tag IDs the coupon applies to.

Example: 411486491630370816

usable_by_customer_idstring · flake-idOptionalExample: 411486491630370816

minimum_order_valueinteger · int64Required

The minimum order value required to use the coupon.

redeem_limit_store_enabledbooleanRequired

Indicates whether a global redemption limit is enabled.

redeem_limit_store_amountinteger · int64Required

The maximum number of times the coupon can be redeemed across the store.

redeem_limit_customer_enabledbooleanRequired

Indicates whether a per-customer redemption limit is enabled.

redeem_limit_customer_amountinteger · int64Required

The maximum number of times the coupon can be redeemed per customer.

usable_on_one_time_purchasebooleanRequired

Indicates whether the coupon can be used for one-time purchases.

usable_on_subscriptionbooleanRequired

Indicates whether the coupon can be used for subscriptions.

usable_atstring · nullableOptional

The date and time when the coupon becomes valid.

expires_atstring · nullableOptional

The date and time when the coupon expires.

created_atstring · date-timeRequired

The date and time when the coupon was created.

updated_atstring · nullableOptional

The date and time when the coupon was last updated.

default

Error response

application/json

patch

/v1/stores/{storeId}/coupons/{couponId}

HTTPcURLJavaScriptPython

PATCH /v1/stores/{storeId}/coupons/{couponId} HTTP/1.1
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 593

{
  "enabled": true,
  "code": "text",
  "note": "text",
  "duration": "once",
  "duration_in_months": null,
  "discount_type": "unspecified",
  "discount_amount": 1,
  "discount_apply_individually": true,
  "discount_apply_before_sales": true,
  "apply_to_products": [
    "411486491630370816"
  ],
  "apply_to_tags": [
    "411486491630370816"
  ],
  "usable_by_customer_id": "411486491630370816",
  "minimum_order_value": 1,
  "redeem_limit_store_enabled": true,
  "redeem_limit_store_amount": 1,
  "redeem_limit_customer_enabled": true,
  "redeem_limit_customer_amount": 1,
  "usable_on_one_time_purchase": true,
  "usable_on_subscription": true,
  "usable_at": null,
  "expires_at": null
}

application/jsontext/jsonapplication/*+json

{
  "id": "411486491630370816",
  "store_id": "411486491630370816",
  "enabled": true,
  "code": "text",
  "note": null,
  "duration": "once",
  "duration_in_months": null,
  "discount_type": "unspecified",
  "discount_amount": 1,
  "discount_apply_individually": true,
  "discount_apply_before_sales": true,
  "apply_to_products": [
    "411486491630370816"
  ],
  "apply_to_tags": [
    "411486491630370816"
  ],
  "usable_by_customer_id": "411486491630370816",
  "minimum_order_value": 1,
  "redeem_limit_store_enabled": true,
  "redeem_limit_store_amount": 1,
  "redeem_limit_customer_enabled": true,
  "redeem_limit_customer_amount": 1,
  "usable_on_one_time_purchase": true,
  "usable_on_subscription": true,
  "usable_at": null,
  "expires_at": null,
  "created_by": {
    "type": "anonymous",
    "id": "411486491630370816"
  },
  "created_at": "2026-02-18T23:00:35.071Z",
  "updated_by": {
    "type": "anonymous",
    "id": "411486491630370816"
  },
  "updated_at": null
}