askell-mcp 0.4.12 → 0.4.14

package/spec/openapi-v2.json

@@ -58,7 +58,11 @@
     },
     {
       "name": "V2 Fulfillment",
-      "description": "Subscription V2 fulfillment order read APIs for warehouse integrations, requires secret api key."
+      "description": "Subscription V2 fulfillment order APIs for warehouse integrations: read the orders, and report back when your own system has shipped or cancelled one. Requires secret api key."
+    },
+    {
+      "name": "V2 Coupons",
+      "description": "Coupon and promotion code management APIs, requires secret api key."
     }
   ],
   "paths": {
@@ -1789,165 +1793,633 @@
           }
         ]
       }
-    }
-  },
-  "components": {
-    "schemas": {
-      "V2ValidationError": {
-        "type": "object",
-        "additionalProperties": true,
-        "example": {
-          "non_field_errors": "Provide exactly one input mode: `bundle_template` or `items`."
-        }
-      },
-      "V2Metadata": {
-        "type": "object",
-        "additionalProperties": true
-      },
-      "V2BillingScheduleRule": {
-        "type": "object",
-        "properties": {
-          "month": {
-            "type": "integer",
-            "nullable": true
-          },
-          "day": {
-            "type": "integer",
-            "nullable": true
-          },
-          "label": {
-            "type": "string",
-            "nullable": true
-          },
-          "display_order": {
-            "type": "integer"
+    },
+    "/v2/fulfillment-orders/{fulfillmentOrderId}/fulfill/": {
+      "post": {
+        "tags": [
+          "V2 Fulfillment"
+        ],
+        "summary": "Report a fulfillment order as shipped",
+        "description": "Records a shipment your own system made and completes the order: every line is marked fulfilled, the order moves to `fulfilled`, the customer is sent the shipped notification and the `fulfillment_order.fulfilled` webhook fires, exactly as when an order is fulfilled from the dashboard. The body is optional — a seller who delivers by hand has no tracking details to report. Idempotent: an order that is already fulfilled comes back unchanged with `200` and nothing is created, emailed or dispatched again. Available whether the account fulfills in Áskell or in an external system, but not while fulfillment is switched off for the account. Requires a secret key.",
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/V2FulfillmentOrderId"
           }
-        }
-      },
-      "V2CatalogPrice": {
-        "type": "object",
-        "properties": {
-          "id": {
-            "type": "integer"
-          },
-          "product_id": {
-            "type": "integer"
-          },
-          "product_name": {
-            "type": "string"
-          },
-          "product_reference": {
-            "type": "string",
-            "nullable": true
-          },
-          "currency": {
-            "type": "string",
-            "example": "ISK"
-          },
-          "unit_amount": {
-            "type": "string",
-            "format": "decimal",
-            "example": "1990.0000"
-          },
-          "billing_type": {
-            "type": "string",
-            "enum": [
-              "recurring",
-              "one_time"
-            ]
-          },
-          "recurrence_type": {
-            "type": "string",
-            "nullable": true
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/V2FulfillmentOrderFulfill"
+              }
+            }
           },
-          "interval": {
-            "type": "string",
-            "nullable": true
+          "required": false
+        },
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/V2FulfillmentOrder"
           },
-          "interval_count": {
-            "type": "integer",
-            "nullable": true
+          "400": {
+            "$ref": "#/components/responses/V2ValidationError"
           },
-          "billing_day_of_month": {
-            "type": "integer",
-            "nullable": true
+          "403": {
+            "$ref": "#/components/responses/V2PermissionDenied"
           },
-          "billing_schedule_id": {
-            "type": "integer",
-            "nullable": true
+          "404": {
+            "$ref": "#/components/responses/V2NotFound"
           },
-          "billing_schedule_name": {
-            "type": "string",
-            "nullable": true
+          "409": {
+            "$ref": "#/components/responses/V2FulfillmentOrderConflict"
+          }
+        },
+        "security": [
+          {
+            "Secret-Api-Key": []
+          }
+        ]
+      }
+    },
+    "/v2/fulfillment-orders/{fulfillmentOrderId}/cancel/": {
+      "post": {
+        "tags": [
+          "V2 Fulfillment"
+        ],
+        "summary": "Cancel a fulfillment order",
+        "description": "Cancels an order that is not going to be shipped. A booking that has not left the provider's hands is retired on the Áskell side and flagged for you to cancel with the carrier itself. Takes no body. Idempotent: an order that is already cancelled comes back with `200` and the `fulfillment_order.cancelled` webhook is not sent again. Requires a secret key and that fulfillment is enabled for the account.",
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/V2FulfillmentOrderId"
+          }
+        ],
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/V2FulfillmentOrder"
           },
-          "billing_schedule_timezone": {
-            "type": "string",
-            "nullable": true
+          "403": {
+            "$ref": "#/components/responses/V2PermissionDenied"
           },
-          "billing_schedule_rules": {
-            "type": "array",
-            "items": {
-              "$ref": "#/components/schemas/V2BillingScheduleRule"
-            }
+          "404": {
+            "$ref": "#/components/responses/V2NotFound"
           },
-          "next_occurrences": {
-            "type": "array",
-            "items": {
+          "409": {
+            "$ref": "#/components/responses/V2FulfillmentOrderConflict"
+          }
+        },
+        "security": [
+          {
+            "Secret-Api-Key": []
+          }
+        ]
+      }
+    },
+    "/v2/coupons/": {
+      "get": {
+        "tags": [
+          "V2 Coupons"
+        ],
+        "summary": "List V2 coupons",
+        "description": "Lists coupons for the authenticated account. Soft-deleted resources are never returned. Requires a secret key.",
+        "parameters": [
+          {
+            "in": "query",
+            "name": "valid",
+            "schema": {
               "type": "string",
-              "format": "date-time"
-            }
-          },
-          "active": {
-            "type": "boolean"
-          },
-          "currently_effective": {
-            "type": "boolean"
+              "enum": [
+                "true",
+                "false"
+              ]
+            },
+            "description": "Filter by whether the coupon can currently be redeemed (live, not expired, redemptions left)."
           },
-          "effective_from": {
-            "type": "string",
-            "format": "date-time",
-            "nullable": true
+          {
+            "in": "query",
+            "name": "duration",
+            "schema": {
+              "type": "string",
+              "enum": [
+                "forever",
+                "once",
+                "repeating"
+              ]
+            },
+            "description": "Filter by duration."
           },
-          "effective_to": {
-            "type": "string",
-            "format": "date-time",
-            "nullable": true
+          {
+            "in": "query",
+            "name": "currency",
+            "schema": {
+              "type": "string"
+            },
+            "description": "Filter amount-off coupons by three-letter ISO currency code."
           },
-          "metadata": {
-            "$ref": "#/components/schemas/V2Metadata"
+          {
+            "in": "query",
+            "name": "name",
+            "schema": {
+              "type": "string"
+            },
+            "description": "Case-insensitive substring match on the coupon name."
           },
-          "created_at": {
-            "type": "string",
-            "format": "date-time"
+          {
+            "$ref": "#/components/parameters/PageSizeFilter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/V2CouponList"
           },
-          "updated_at": {
-            "type": "string",
-            "format": "date-time"
+          "400": {
+            "$ref": "#/components/responses/V2ValidationError"
           }
-        }
+        },
+        "security": [
+          {
+            "Secret-Api-Key": []
+          }
+        ]
       },
-      "V2CatalogProduct": {
-        "type": "object",
-        "properties": {
-          "id": {
-            "type": "integer"
-          },
-          "name": {
-            "type": "string"
-          },
-          "description": {
-            "type": "string",
-            "nullable": true
-          },
-          "reference": {
-            "type": "string",
-            "nullable": true
+      "post": {
+        "tags": [
+          "V2 Coupons"
+        ],
+        "summary": "Create a V2 coupon",
+        "description": "Creates a coupon. Exactly one of `amount_off` (with `currency`) or `percent_off` must be set. `duration_in_months` is required when `duration` is `repeating` and must be omitted otherwise. `redeem_by` must be in the future. Requires a secret key.",
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/V2CouponCreate"
+              }
+            }
           },
-          "image_url": {
-            "type": "string",
-            "nullable": true
+          "required": true
+        },
+        "responses": {
+          "201": {
+            "$ref": "#/components/responses/V2Coupon"
           },
-          "active": {
+          "400": {
+            "$ref": "#/components/responses/V2ValidationError"
+          }
+        },
+        "security": [
+          {
+            "Secret-Api-Key": []
+          }
+        ]
+      }
+    },
+    "/v2/coupons/{couponId}/": {
+      "get": {
+        "tags": [
+          "V2 Coupons"
+        ],
+        "summary": "Get a V2 coupon",
+        "description": "Returns a single coupon for the authenticated account. Requires a secret key.",
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/V2CouponId"
+          }
+        ],
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/V2Coupon"
+          },
+          "404": {
+            "$ref": "#/components/responses/V2NotFound"
+          }
+        },
+        "security": [
+          {
+            "Secret-Api-Key": []
+          }
+        ]
+      },
+      "patch": {
+        "tags": [
+          "V2 Coupons"
+        ],
+        "summary": "Update a V2 coupon",
+        "description": "Partially updates a coupon. To switch from `percent_off` to `amount_off` (or back) send the old field as `null` in the same request. `id` and `times_redeemed` cannot be changed. Requires a secret key.",
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/V2CouponId"
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/V2CouponPatch"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/V2Coupon"
+          },
+          "400": {
+            "$ref": "#/components/responses/V2ValidationError"
+          },
+          "404": {
+            "$ref": "#/components/responses/V2NotFound"
+          }
+        },
+        "security": [
+          {
+            "Secret-Api-Key": []
+          }
+        ]
+      },
+      "delete": {
+        "tags": [
+          "V2 Coupons"
+        ],
+        "summary": "Delete a V2 coupon",
+        "description": "Soft-deletes a coupon so it can no longer be redeemed and is hidden from list and detail responses. Coupons that have already been redeemed cannot be deleted; retire them with `redeem_by` or `max_redemptions` instead. Requires a secret key.",
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/V2CouponId"
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "Deleted"
+          },
+          "400": {
+            "$ref": "#/components/responses/V2ValidationError"
+          },
+          "404": {
+            "$ref": "#/components/responses/V2NotFound"
+          }
+        },
+        "security": [
+          {
+            "Secret-Api-Key": []
+          }
+        ]
+      }
+    },
+    "/v2/promotion-codes/": {
+      "get": {
+        "tags": [
+          "V2 Coupons"
+        ],
+        "summary": "List V2 promotion codes",
+        "description": "Lists promotion codes for the authenticated account. Soft-deleted resources are never returned. Requires a secret key.",
+        "parameters": [
+          {
+            "in": "query",
+            "name": "code",
+            "schema": {
+              "type": "string"
+            },
+            "description": "Exact, case-insensitive match on the customer-facing code."
+          },
+          {
+            "in": "query",
+            "name": "coupon",
+            "schema": {
+              "type": "string"
+            },
+            "description": "Filter by coupon id."
+          },
+          {
+            "in": "query",
+            "name": "active",
+            "schema": {
+              "type": "string",
+              "enum": [
+                "true",
+                "false"
+              ]
+            },
+            "description": "Filter by the active flag."
+          },
+          {
+            "in": "query",
+            "name": "valid",
+            "schema": {
+              "type": "string",
+              "enum": [
+                "true",
+                "false"
+              ]
+            },
+            "description": "Filter by whether the code can currently be redeemed (active, not expired, redemptions left, and coupon valid)."
+          },
+          {
+            "in": "query",
+            "name": "customer_reference",
+            "schema": {
+              "type": "string"
+            },
+            "description": "Filter codes restricted to the customer with this reference."
+          },
+          {
+            "$ref": "#/components/parameters/PageSizeFilter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/V2PromotionCodeList"
+          },
+          "400": {
+            "$ref": "#/components/responses/V2ValidationError"
+          }
+        },
+        "security": [
+          {
+            "Secret-Api-Key": []
+          }
+        ]
+      },
+      "post": {
+        "tags": [
+          "V2 Coupons"
+        ],
+        "summary": "Create a V2 promotion code",
+        "description": "Creates a promotion code for a coupon owned by the authenticated account. `code` is normalised to upper case and generated when omitted; it must be unique among active codes for the account. Restrict the code to one customer with either `customer` (id) or `customer_reference`. Requires a secret key.",
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/V2PromotionCodeCreate"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "201": {
+            "$ref": "#/components/responses/V2PromotionCode"
+          },
+          "400": {
+            "$ref": "#/components/responses/V2ValidationError"
+          }
+        },
+        "security": [
+          {
+            "Secret-Api-Key": []
+          }
+        ]
+      }
+    },
+    "/v2/promotion-codes/{promotionCodeId}/": {
+      "get": {
+        "tags": [
+          "V2 Coupons"
+        ],
+        "summary": "Get a V2 promotion code",
+        "description": "Returns a single promotion code for the authenticated account. Requires a secret key.",
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/V2PromotionCodeId"
+          }
+        ],
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/V2PromotionCode"
+          },
+          "404": {
+            "$ref": "#/components/responses/V2NotFound"
+          }
+        },
+        "security": [
+          {
+            "Secret-Api-Key": []
+          }
+        ]
+      },
+      "patch": {
+        "tags": [
+          "V2 Coupons"
+        ],
+        "summary": "Update a V2 promotion code",
+        "description": "Partially updates a promotion code. Send `customer` or `customer_reference` as `null` to remove a customer restriction. Set `active` to `false` to retire a code without deleting it; the code can then be reused by a new promotion code. `id` and `times_redeemed` cannot be changed. Requires a secret key.",
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/V2PromotionCodeId"
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/V2PromotionCodePatch"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/V2PromotionCode"
+          },
+          "400": {
+            "$ref": "#/components/responses/V2ValidationError"
+          },
+          "404": {
+            "$ref": "#/components/responses/V2NotFound"
+          }
+        },
+        "security": [
+          {
+            "Secret-Api-Key": []
+          }
+        ]
+      },
+      "delete": {
+        "tags": [
+          "V2 Coupons"
+        ],
+        "summary": "Delete a V2 promotion code",
+        "description": "Soft-deletes a promotion code, freeing its code for reuse. Promotion codes that have already been redeemed cannot be deleted; set `active` to `false` instead. Requires a secret key.",
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/V2PromotionCodeId"
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "Deleted"
+          },
+          "400": {
+            "$ref": "#/components/responses/V2ValidationError"
+          },
+          "404": {
+            "$ref": "#/components/responses/V2NotFound"
+          }
+        },
+        "security": [
+          {
+            "Secret-Api-Key": []
+          }
+        ]
+      }
+    }
+  },
+  "components": {
+    "schemas": {
+      "V2ValidationError": {
+        "type": "object",
+        "additionalProperties": true,
+        "example": {
+          "non_field_errors": "Provide exactly one input mode: `bundle_template` or `items`."
+        }
+      },
+      "V2Metadata": {
+        "type": "object",
+        "additionalProperties": true
+      },
+      "V2BillingScheduleRule": {
+        "type": "object",
+        "properties": {
+          "month": {
+            "type": "integer",
+            "nullable": true
+          },
+          "day": {
+            "type": "integer",
+            "nullable": true
+          },
+          "label": {
+            "type": "string",
+            "nullable": true
+          },
+          "display_order": {
+            "type": "integer"
+          }
+        }
+      },
+      "V2CatalogPrice": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "integer"
+          },
+          "product_id": {
+            "type": "integer"
+          },
+          "product_name": {
+            "type": "string"
+          },
+          "product_reference": {
+            "type": "string",
+            "nullable": true
+          },
+          "currency": {
+            "type": "string",
+            "example": "ISK"
+          },
+          "unit_amount": {
+            "type": "string",
+            "format": "decimal",
+            "example": "1990.0000"
+          },
+          "billing_type": {
+            "type": "string",
+            "enum": [
+              "recurring",
+              "one_time"
+            ]
+          },
+          "recurrence_type": {
+            "type": "string",
+            "nullable": true
+          },
+          "interval": {
+            "type": "string",
+            "nullable": true
+          },
+          "interval_count": {
+            "type": "integer",
+            "nullable": true
+          },
+          "billing_day_of_month": {
+            "type": "integer",
+            "nullable": true
+          },
+          "billing_schedule_id": {
+            "type": "integer",
+            "nullable": true
+          },
+          "billing_schedule_name": {
+            "type": "string",
+            "nullable": true
+          },
+          "billing_schedule_timezone": {
+            "type": "string",
+            "nullable": true
+          },
+          "billing_schedule_rules": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/V2BillingScheduleRule"
+            }
+          },
+          "next_occurrences": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "format": "date-time"
+            }
+          },
+          "active": {
+            "type": "boolean"
+          },
+          "currently_effective": {
+            "type": "boolean"
+          },
+          "effective_from": {
+            "type": "string",
+            "format": "date-time",
+            "nullable": true
+          },
+          "effective_to": {
+            "type": "string",
+            "format": "date-time",
+            "nullable": true
+          },
+          "metadata": {
+            "$ref": "#/components/schemas/V2Metadata"
+          },
+          "created_at": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "updated_at": {
+            "type": "string",
+            "format": "date-time"
+          }
+        }
+      },
+      "V2CatalogProduct": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "integer"
+          },
+          "name": {
+            "type": "string"
+          },
+          "description": {
+            "type": "string",
+            "nullable": true
+          },
+          "reference": {
+            "type": "string",
+            "nullable": true
+          },
+          "image_url": {
+            "type": "string",
+            "nullable": true
+          },
+          "active": {
             "type": "boolean"
           },
           "tax_policy": {
@@ -3289,6 +3761,11 @@
             "type": "string",
             "description": "The weight band that priced the selection as `min-max` in grams (`max` empty for an open-ended band), or an empty string for a flat-priced option."
           },
+          "provider_quote": {
+            "type": "object",
+            "description": "The carrier quote that priced the selection, for an option priced by the carrier's own live quote; an empty object for every other option. Keys: `service_id` (the carrier's delivery service, such as `DPP108`), `booked_service_id` (the delivery service the shipment is booked under, which need not be spelled the same as the quoted one, and is empty when the selection has no service code to build it from), `name`, `gross_price` and `net_price` as decimal strings, and `request` with the `country_code`, `zip_code` and `weight_grams` the quote answered.",
+            "additionalProperties": true
+          },
           "location_id": {
             "type": "string"
           },
@@ -4790,6 +5267,44 @@
           }
         }
       },
+      "V2FulfillmentOrderFulfill": {
+        "type": "object",
+        "description": "What an external fulfillment system reports back when it has shipped an order. Every field is optional; an empty object just closes the order.",
+        "properties": {
+          "tracking_number": {
+            "type": "string",
+            "maxLength": 128,
+            "description": "Tracking number for the parcel. Included in the shipped notification sent to the customer.",
+            "example": "PP123456789"
+          },
+          "tracking_url": {
+            "type": "string",
+            "format": "uri",
+            "maxLength": 512,
+            "description": "A URL the shipment can be tracked at. Stored with the shipment and served back as the shipment's `tracking_url`.",
+            "example": "https://posturinn.is/track/PP123456789"
+          },
+          "provider_order_id": {
+            "type": "string",
+            "maxLength": 128,
+            "description": "The carrier's own identifier for the shipment.",
+            "example": "shp_8812"
+          },
+          "carrier": {
+            "type": "string",
+            "maxLength": 64,
+            "description": "The carrier that took the parcel. `dropp` and `posturinn` are recognised and file the shipment under that handler; anything else is kept as free text.",
+            "example": "posturinn"
+          },
+          "weight_grams": {
+            "type": "integer",
+            "minimum": 0,
+            "nullable": true,
+            "description": "Parcel weight in grams.",
+            "example": 1000
+          }
+        }
+      },
       "V2FulfillmentAddress": {
         "type": "object",
         "nullable": true,
@@ -4870,12 +5385,18 @@
           },
           "handler": {
             "type": "string",
+            "description": "The shipping handler the shipment was booked with. Empty when an external fulfillment system shipped the order with a carrier Áskell has no integration for — read `carrier` for the name it reported.",
             "enum": [
               "dropp",
               "posturinn",
-              "store_pickup"
+              "store_pickup",
+              ""
             ]
           },
+          "carrier": {
+            "type": "string",
+            "description": "What carried the parcel: the carrier an external system reported, or the handler that booked it. Empty only when neither is known."
+          },
           "status": {
             "type": "string",
             "enum": [
@@ -4894,6 +5415,11 @@
           "tracking_number": {
             "type": "string"
           },
+          "tracking_url": {
+            "type": "string",
+            "format": "uri",
+            "description": "A URL the shipment can be tracked at, as reported through the fulfill endpoint. Empty when none was reported."
+          },
           "weight_grams": {
             "type": "integer",
             "nullable": true,
@@ -5025,57 +5551,167 @@
             "type": "string",
             "nullable": true
           },
-          "interval_count": {
-            "type": "integer",
+          "interval_count": {
+            "type": "integer",
+            "nullable": true
+          },
+          "billing_day_of_month": {
+            "type": "integer",
+            "nullable": true
+          },
+          "billing_schedule_id": {
+            "type": "integer",
+            "nullable": true
+          },
+          "billing_schedule_name": {
+            "type": "string",
+            "nullable": true
+          }
+        }
+      },
+      "V2SubscriptionContractPauseWindow": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "integer"
+          },
+          "start_date": {
+            "type": "string",
+            "format": "date"
+          },
+          "end_date": {
+            "type": "string",
+            "format": "date"
+          },
+          "active": {
+            "type": "boolean"
+          },
+          "created_at": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "updated_at": {
+            "type": "string",
+            "format": "date-time"
+          }
+        }
+      },
+      "V2EntitlementSummary": {
+        "type": "object",
+        "description": "Aggregate service entitlement state for a subscription contract.",
+        "properties": {
+          "service_active": {
+            "type": "boolean"
+          },
+          "service_state": {
+            "type": "string",
+            "enum": [
+              "active",
+              "inactive",
+              "partial",
+              "past_due"
+            ]
+          },
+          "active_service_item_count": {
+            "type": "integer"
+          },
+          "inactive_service_item_count": {
+            "type": "integer"
+          },
+          "past_due_service_item_count": {
+            "type": "integer"
+          },
+          "total_active_quantity": {
+            "type": "integer"
+          },
+          "active_product_ids": {
+            "type": "array",
+            "items": {
+              "type": "integer"
+            }
+          },
+          "evaluated_at": {
+            "type": "string",
+            "format": "date-time"
+          }
+        }
+      },
+      "V2CustomerEntitlementItem": {
+        "type": "object",
+        "description": "One contract item considered by the customer entitlement access check.",
+        "properties": {
+          "subscription_contract_id": {
+            "type": "integer"
+          },
+          "contract_item_id": {
+            "type": "integer"
+          },
+          "product_id": {
+            "type": "integer"
+          },
+          "product_reference": {
+            "type": "string",
+            "nullable": true
+          },
+          "price_id": {
+            "type": "integer"
+          },
+          "quantity": {
+            "type": "integer"
+          },
+          "service_active": {
+            "type": "boolean"
+          },
+          "service_state": {
+            "type": "string",
+            "enum": [
+              "inactive",
+              "active",
+              "pending_payment",
+              "past_due",
+              "ended"
+            ]
+          },
+          "entitled_from": {
+            "type": "string",
+            "format": "date-time",
+            "nullable": true
+          },
+          "entitled_until": {
+            "type": "string",
+            "format": "date-time",
+            "nullable": true
+          },
+          "current_service_period_start_at": {
+            "type": "string",
+            "format": "date-time",
             "nullable": true
           },
-          "billing_day_of_month": {
-            "type": "integer",
+          "current_service_period_end_at": {
+            "type": "string",
+            "format": "date-time",
             "nullable": true
           },
-          "billing_schedule_id": {
+          "entitlement_billing_run_id": {
             "type": "integer",
             "nullable": true
-          },
-          "billing_schedule_name": {
-            "type": "string",
-            "nullable": true
           }
         }
       },
-      "V2SubscriptionContractPauseWindow": {
+      "V2CustomerEntitlements": {
         "type": "object",
+        "description": "Customer/product service entitlement access-check response.",
         "properties": {
-          "id": {
-            "type": "integer"
-          },
-          "start_date": {
-            "type": "string",
-            "format": "date"
-          },
-          "end_date": {
-            "type": "string",
-            "format": "date"
-          },
-          "active": {
-            "type": "boolean"
+          "customer_reference": {
+            "type": "string"
           },
-          "created_at": {
+          "product_reference": {
             "type": "string",
-            "format": "date-time"
+            "nullable": true
           },
-          "updated_at": {
-            "type": "string",
-            "format": "date-time"
-          }
-        }
-      },
-      "V2EntitlementSummary": {
-        "type": "object",
-        "description": "Aggregate service entitlement state for a subscription contract.",
-        "properties": {
           "service_active": {
-            "type": "boolean"
+            "type": "boolean",
+            "description": "Simple integration-facing access flag."
           },
           "service_state": {
             "type": "string",
@@ -5086,15 +5722,6 @@
               "past_due"
             ]
           },
-          "active_service_item_count": {
-            "type": "integer"
-          },
-          "inactive_service_item_count": {
-            "type": "integer"
-          },
-          "past_due_service_item_count": {
-            "type": "integer"
-          },
           "total_active_quantity": {
             "type": "integer"
           },
@@ -5107,31 +5734,69 @@
           "evaluated_at": {
             "type": "string",
             "format": "date-time"
+          },
+          "items": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/V2CustomerEntitlementItem"
+            }
           }
         }
       },
-      "V2CustomerEntitlementItem": {
+      "V2SubscriptionContract": {
         "type": "object",
-        "description": "One contract item considered by the customer entitlement access check.",
         "properties": {
-          "subscription_contract_id": {
+          "id": {
             "type": "integer"
           },
-          "contract_item_id": {
+          "customer_id": {
             "type": "integer"
           },
-          "product_id": {
-            "type": "integer"
+          "customer": {
+            "$ref": "#/components/schemas/V2SubscriptionContractCustomer"
           },
-          "product_reference": {
+          "customer_reference": {
+            "type": "string"
+          },
+          "shipping_selection": {
+            "$ref": "#/components/schemas/V2ShippingSelection"
+          },
+          "discount": {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/V2ContractDiscount"
+              }
+            ],
+            "nullable": true,
+            "description": "The active coupon discount on this contract, if any."
+          },
+          "state": {
+            "type": "string"
+          },
+          "billing_anchor_at": {
             "type": "string",
+            "format": "date-time",
             "nullable": true
           },
-          "price_id": {
-            "type": "integer"
+          "billing_timezone": {
+            "type": "string"
           },
-          "quantity": {
-            "type": "integer"
+          "billing_time": {
+            "type": "string"
+          },
+          "billing_advance_policy": {
+            "type": "string",
+            "enum": [
+              "on_run_created",
+              "on_run_succeeded"
+            ]
+          },
+          "service_entitlement_policy": {
+            "type": "string",
+            "enum": [
+              "on_run_created",
+              "on_run_succeeded"
+            ]
           },
           "service_active": {
             "type": "boolean"
@@ -5139,233 +5804,460 @@
           "service_state": {
             "type": "string",
             "enum": [
-              "inactive",
               "active",
-              "pending_payment",
-              "past_due",
-              "ended"
+              "inactive",
+              "partial",
+              "past_due"
             ]
           },
-          "entitled_from": {
+          "active_service_item_count": {
+            "type": "integer"
+          },
+          "inactive_service_item_count": {
+            "type": "integer"
+          },
+          "total_active_quantity": {
+            "type": "integer"
+          },
+          "entitlement_summary": {
+            "$ref": "#/components/schemas/V2EntitlementSummary"
+          },
+          "billing_attention_required": {
+            "type": "boolean"
+          },
+          "trial_start_at": {
             "type": "string",
             "format": "date-time",
             "nullable": true
           },
-          "entitled_until": {
+          "trial_end_at": {
+            "type": "string",
+            "format": "date-time",
+            "nullable": true
+          },
+          "next_billing_at": {
+            "type": "string",
+            "format": "date-time",
+            "nullable": true
+          },
+          "cancel_at": {
+            "type": "string",
+            "format": "date-time",
+            "nullable": true
+          },
+          "cancel_at_period_end": {
+            "type": "boolean"
+          },
+          "canceled_at": {
+            "type": "string",
+            "format": "date-time",
+            "nullable": true
+          },
+          "ended_at": {
             "type": "string",
             "format": "date-time",
             "nullable": true
           },
-          "current_service_period_start_at": {
-            "type": "string",
-            "format": "date-time",
+          "currency": {
+            "type": "string"
+          },
+          "recurring": {
+            "type": "boolean"
+          },
+          "has_future_pause": {
+            "type": "boolean"
+          },
+          "paused_until": {
+            "type": "string",
+            "format": "date",
+            "nullable": true
+          },
+          "payment_processor_override_id": {
+            "type": "integer",
+            "nullable": true
+          },
+          "legacy_subscription_ids": {
+            "type": "array",
+            "items": {
+              "type": "integer"
+            }
+          },
+          "metadata": {
+            "$ref": "#/components/schemas/V2Metadata"
+          },
+          "subscriber_page": {
+            "type": "string",
+            "format": "uri",
+            "nullable": true,
+            "readOnly": true,
+            "description": "Absolute URL of the customer-facing subscription management page for this contract."
+          },
+          "created_at": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "updated_at": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "items": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/V2SubscriptionContractItem"
+            }
+          },
+          "pauses": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/V2SubscriptionContractPauseWindow"
+            }
+          },
+          "current_pauses": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/V2SubscriptionContractPauseWindow"
+            }
+          },
+          "future_pauses": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/V2SubscriptionContractPauseWindow"
+            }
+          },
+          "past_pauses": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/V2SubscriptionContractPauseWindow"
+            }
+          },
+          "billing_cadence": {
+            "$ref": "#/components/schemas/V2SubscriptionContractBillingCadence"
+          },
+          "bundle_purchases": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/V2BundlePurchaseSummary"
+            }
+          },
+          "bundle_purchase_id": {
+            "type": "integer",
+            "nullable": true
+          },
+          "initial_billing_run": {
+            "$ref": "#/components/schemas/V2BillingRunSummary"
+          },
+          "initial_billing_run_id": {
+            "type": "integer",
             "nullable": true
           },
-          "current_service_period_end_at": {
+          "initial_billing_run_total_amount": {
             "type": "string",
-            "format": "date-time",
+            "format": "decimal",
             "nullable": true
           },
-          "entitlement_billing_run_id": {
-            "type": "integer",
-            "nullable": true
+          "latest_billing_run": {
+            "$ref": "#/components/schemas/V2BillingRunSummary"
           }
         }
       },
-      "V2CustomerEntitlements": {
+      "V2Coupon": {
         "type": "object",
-        "description": "Customer/product service entitlement access-check response.",
         "properties": {
-          "customer_reference": {
-            "type": "string"
+          "id": {
+            "type": "string",
+            "example": "coup_5f3a1c2b9d8e4f6a7b8c9d0e"
           },
-          "product_reference": {
+          "name": {
             "type": "string",
             "nullable": true
           },
-          "service_active": {
-            "type": "boolean",
-            "description": "Simple integration-facing access flag."
+          "amount_off": {
+            "type": "string",
+            "format": "decimal",
+            "nullable": true,
+            "description": "Fixed amount taken off. Mutually exclusive with `percent_off`.",
+            "example": "500.00"
           },
-          "service_state": {
+          "currency": {
+            "type": "string",
+            "nullable": true,
+            "description": "Three-letter ISO 4217 currency code. Required with `amount_off`.",
+            "example": "ISK"
+          },
+          "percent_off": {
+            "type": "string",
+            "format": "decimal",
+            "nullable": true,
+            "description": "Percentage taken off (0.01-100). Mutually exclusive with `amount_off`.",
+            "example": "10.00"
+          },
+          "discount_display": {
+            "type": "string",
+            "example": "10.00%"
+          },
+          "duration": {
             "type": "string",
             "enum": [
-              "active",
-              "inactive",
-              "partial",
-              "past_due"
+              "forever",
+              "once",
+              "repeating"
             ]
           },
-          "total_active_quantity": {
+          "duration_in_months": {
+            "type": "integer",
+            "nullable": true,
+            "minimum": 1,
+            "description": "Required when `duration` is `repeating`."
+          },
+          "skip_trial_period": {
+            "type": "boolean",
+            "description": "Bypass the plan trial period when the coupon is applied at checkout."
+          },
+          "max_redemptions": {
+            "type": "integer",
+            "nullable": true,
+            "minimum": 1
+          },
+          "times_redeemed": {
             "type": "integer"
           },
-          "active_product_ids": {
-            "type": "array",
-            "items": {
-              "type": "integer"
-            }
+          "redeem_by": {
+            "type": "string",
+            "format": "date-time",
+            "nullable": true
           },
-          "evaluated_at": {
+          "valid": {
+            "type": "boolean",
+            "description": "Whether the coupon can currently be redeemed."
+          },
+          "metadata": {
+            "$ref": "#/components/schemas/V2Metadata"
+          },
+          "created_at": {
             "type": "string",
             "format": "date-time"
           },
-          "items": {
-            "type": "array",
-            "items": {
-              "$ref": "#/components/schemas/V2CustomerEntitlementItem"
-            }
+          "updated_at": {
+            "type": "string",
+            "format": "date-time"
           }
         }
       },
-      "V2SubscriptionContract": {
+      "V2CouponCreate": {
         "type": "object",
+        "required": [
+          "duration"
+        ],
         "properties": {
           "id": {
-            "type": "integer"
+            "type": "string",
+            "example": "coup_5f3a1c2b9d8e4f6a7b8c9d0e",
+            "description": "Optional custom id (letters, digits, underscores, hyphens and dots, max 128 characters; `.` and `..` are not allowed). Generated when omitted.",
+            "pattern": "^(?!\\.{1,2}$)[A-Za-z0-9_.-]{1,128}$"
           },
-          "customer_id": {
-            "type": "integer"
+          "name": {
+            "type": "string",
+            "nullable": true
           },
-          "customer": {
-            "$ref": "#/components/schemas/V2SubscriptionContractCustomer"
+          "amount_off": {
+            "type": "string",
+            "format": "decimal",
+            "nullable": true,
+            "description": "Fixed amount taken off. Mutually exclusive with `percent_off`.",
+            "example": "500.00"
           },
-          "customer_reference": {
-            "type": "string"
+          "currency": {
+            "type": "string",
+            "nullable": true,
+            "description": "Three-letter ISO 4217 currency code. Required with `amount_off`.",
+            "example": "ISK"
           },
-          "shipping_selection": {
-            "$ref": "#/components/schemas/V2ShippingSelection"
+          "percent_off": {
+            "type": "string",
+            "format": "decimal",
+            "nullable": true,
+            "description": "Percentage taken off (0.01-100). Mutually exclusive with `amount_off`.",
+            "example": "10.00"
           },
-          "discount": {
-            "allOf": [
-              {
-                "$ref": "#/components/schemas/V2ContractDiscount"
-              }
-            ],
+          "duration": {
+            "type": "string",
+            "enum": [
+              "forever",
+              "once",
+              "repeating"
+            ]
+          },
+          "duration_in_months": {
+            "type": "integer",
             "nullable": true,
-            "description": "The active coupon discount on this contract, if any."
+            "minimum": 1,
+            "description": "Required when `duration` is `repeating`."
           },
-          "state": {
-            "type": "string"
+          "skip_trial_period": {
+            "type": "boolean",
+            "description": "Bypass the plan trial period when the coupon is applied at checkout."
           },
-          "billing_anchor_at": {
+          "max_redemptions": {
+            "type": "integer",
+            "nullable": true,
+            "minimum": 1
+          },
+          "redeem_by": {
             "type": "string",
             "format": "date-time",
             "nullable": true
           },
-          "billing_timezone": {
-            "type": "string"
-          },
-          "billing_time": {
-            "type": "string"
+          "metadata": {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/V2Metadata"
+              }
+            ],
+            "nullable": true
+          }
+        },
+        "additionalProperties": false
+      },
+      "V2CouponPatch": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "type": "string",
+            "nullable": true
           },
-          "billing_advance_policy": {
+          "amount_off": {
             "type": "string",
-            "enum": [
-              "on_run_created",
-              "on_run_succeeded"
-            ]
+            "format": "decimal",
+            "nullable": true,
+            "description": "Fixed amount taken off. Mutually exclusive with `percent_off`.",
+            "example": "500.00"
           },
-          "service_entitlement_policy": {
+          "currency": {
             "type": "string",
-            "enum": [
-              "on_run_created",
-              "on_run_succeeded"
-            ]
+            "nullable": true,
+            "description": "Three-letter ISO 4217 currency code. Required with `amount_off`.",
+            "example": "ISK"
           },
-          "service_active": {
-            "type": "boolean"
+          "percent_off": {
+            "type": "string",
+            "format": "decimal",
+            "nullable": true,
+            "description": "Percentage taken off (0.01-100). Mutually exclusive with `amount_off`.",
+            "example": "10.00"
           },
-          "service_state": {
+          "duration": {
             "type": "string",
             "enum": [
-              "active",
-              "inactive",
-              "partial",
-              "past_due"
+              "forever",
+              "once",
+              "repeating"
             ]
           },
-          "active_service_item_count": {
-            "type": "integer"
-          },
-          "inactive_service_item_count": {
-            "type": "integer"
-          },
-          "total_active_quantity": {
-            "type": "integer"
+          "duration_in_months": {
+            "type": "integer",
+            "nullable": true,
+            "minimum": 1,
+            "description": "Required when `duration` is `repeating`."
           },
-          "entitlement_summary": {
-            "$ref": "#/components/schemas/V2EntitlementSummary"
+          "skip_trial_period": {
+            "type": "boolean",
+            "description": "Bypass the plan trial period when the coupon is applied at checkout."
           },
-          "billing_attention_required": {
-            "type": "boolean"
+          "max_redemptions": {
+            "type": "integer",
+            "nullable": true,
+            "minimum": 1
           },
-          "trial_start_at": {
+          "redeem_by": {
             "type": "string",
             "format": "date-time",
             "nullable": true
           },
-          "trial_end_at": {
-            "type": "string",
-            "format": "date-time",
+          "metadata": {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/V2Metadata"
+              }
+            ],
             "nullable": true
-          },
-          "next_billing_at": {
+          }
+        },
+        "additionalProperties": false
+      },
+      "V2PromotionCode": {
+        "type": "object",
+        "properties": {
+          "id": {
             "type": "string",
-            "format": "date-time",
-            "nullable": true
+            "example": "promo_5f3a1c2b9d8e4f6a7b8c9d0e"
           },
-          "cancel_at": {
+          "code": {
             "type": "string",
-            "format": "date-time",
-            "nullable": true
+            "description": "Customer-facing code (4-50 letters, digits, hyphens or underscores). Stored in upper case.",
+            "example": "SUMMER20"
           },
-          "cancel_at_period_end": {
-            "type": "boolean"
-          },
-          "canceled_at": {
+          "coupon": {
             "type": "string",
-            "format": "date-time",
-            "nullable": true
+            "description": "Coupon id.",
+            "example": "coup_5f3a1c2b9d8e4f6a7b8c9d0e"
           },
-          "ended_at": {
+          "coupon_name": {
             "type": "string",
-            "format": "date-time",
             "nullable": true
           },
-          "currency": {
-            "type": "string"
+          "coupon_discount_display": {
+            "type": "string",
+            "example": "10.00%"
           },
-          "recurring": {
+          "active": {
             "type": "boolean"
           },
-          "has_future_pause": {
-            "type": "boolean"
+          "customer_id": {
+            "type": "integer",
+            "nullable": true
           },
-          "paused_until": {
+          "customer_reference": {
             "type": "string",
-            "format": "date",
             "nullable": true
           },
-          "payment_processor_override_id": {
+          "max_redemptions": {
             "type": "integer",
+            "nullable": true,
+            "minimum": 1
+          },
+          "times_redeemed": {
+            "type": "integer"
+          },
+          "expires_at": {
+            "type": "string",
+            "format": "date-time",
             "nullable": true
           },
-          "legacy_subscription_ids": {
-            "type": "array",
-            "items": {
-              "type": "integer"
-            }
+          "restrictions": {
+            "type": "object",
+            "description": "Redemption restrictions. Only a minimum order amount is supported; `minimum_amount` and `minimum_amount_currency` must be provided together, or send an empty object to remove the restriction.",
+            "properties": {
+              "minimum_amount": {
+                "type": "string",
+                "format": "decimal",
+                "description": "Minimum amount the code can be applied to. Must be greater than zero.",
+                "example": "1000"
+              },
+              "minimum_amount_currency": {
+                "type": "string",
+                "description": "Three-letter ISO 4217 code of `minimum_amount`.",
+                "example": "ISK"
+              }
+            },
+            "additionalProperties": false
+          },
+          "valid": {
+            "type": "boolean",
+            "description": "Whether the code can currently be redeemed."
           },
           "metadata": {
             "$ref": "#/components/schemas/V2Metadata"
           },
-          "subscriber_page": {
-            "type": "string",
-            "format": "uri",
-            "nullable": true,
-            "readOnly": true,
-            "description": "Absolute URL of the customer-facing subscription management page for this contract."
-          },
           "created_at": {
             "type": "string",
             "format": "date-time"
@@ -5373,66 +6265,149 @@
           "updated_at": {
             "type": "string",
             "format": "date-time"
+          }
+        }
+      },
+      "V2PromotionCodeCreate": {
+        "type": "object",
+        "required": [
+          "coupon"
+        ],
+        "properties": {
+          "id": {
+            "type": "string",
+            "example": "promo_5f3a1c2b9d8e4f6a7b8c9d0e",
+            "description": "Optional custom id (letters, digits, underscores, hyphens and dots, max 128 characters; `.` and `..` are not allowed). Generated when omitted.",
+            "pattern": "^(?!\\.{1,2}$)[A-Za-z0-9_.-]{1,128}$"
           },
-          "items": {
-            "type": "array",
-            "items": {
-              "$ref": "#/components/schemas/V2SubscriptionContractItem"
-            }
+          "code": {
+            "type": "string",
+            "description": "Customer-facing code (4-50 letters, digits, hyphens or underscores). Stored in upper case. Generated when omitted.",
+            "example": "SUMMER20"
           },
-          "pauses": {
-            "type": "array",
-            "items": {
-              "$ref": "#/components/schemas/V2SubscriptionContractPauseWindow"
-            }
+          "coupon": {
+            "type": "string",
+            "description": "Coupon id.",
+            "example": "coup_5f3a1c2b9d8e4f6a7b8c9d0e"
           },
-          "current_pauses": {
-            "type": "array",
-            "items": {
-              "$ref": "#/components/schemas/V2SubscriptionContractPauseWindow"
-            }
+          "active": {
+            "type": "boolean"
           },
-          "future_pauses": {
-            "type": "array",
-            "items": {
-              "$ref": "#/components/schemas/V2SubscriptionContractPauseWindow"
-            }
+          "customer": {
+            "type": "integer",
+            "nullable": true,
+            "description": "Customer id to restrict the code to. Mutually exclusive with `customer_reference`."
           },
-          "past_pauses": {
-            "type": "array",
-            "items": {
-              "$ref": "#/components/schemas/V2SubscriptionContractPauseWindow"
-            }
+          "customer_reference": {
+            "type": "string",
+            "nullable": true,
+            "description": "Customer reference to restrict the code to. Mutually exclusive with `customer`."
           },
-          "billing_cadence": {
-            "$ref": "#/components/schemas/V2SubscriptionContractBillingCadence"
+          "max_redemptions": {
+            "type": "integer",
+            "nullable": true,
+            "minimum": 1
           },
-          "bundle_purchases": {
-            "type": "array",
-            "items": {
-              "$ref": "#/components/schemas/V2BundlePurchaseSummary"
-            }
+          "expires_at": {
+            "type": "string",
+            "format": "date-time",
+            "nullable": true
           },
-          "bundle_purchase_id": {
-            "type": "integer",
+          "restrictions": {
+            "type": "object",
+            "nullable": true,
+            "description": "Redemption restrictions. Only a minimum order amount is supported; `minimum_amount` and `minimum_amount_currency` must be provided together, or send an empty object to remove the restriction.",
+            "properties": {
+              "minimum_amount": {
+                "type": "string",
+                "format": "decimal",
+                "description": "Minimum amount the code can be applied to. Must be greater than zero.",
+                "example": "1000"
+              },
+              "minimum_amount_currency": {
+                "type": "string",
+                "description": "Three-letter ISO 4217 code of `minimum_amount`.",
+                "example": "ISK"
+              }
+            },
+            "additionalProperties": false
+          },
+          "metadata": {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/V2Metadata"
+              }
+            ],
             "nullable": true
+          }
+        },
+        "additionalProperties": false
+      },
+      "V2PromotionCodePatch": {
+        "type": "object",
+        "properties": {
+          "code": {
+            "type": "string",
+            "description": "Customer-facing code (4-50 letters, digits, hyphens or underscores). Stored in upper case.",
+            "example": "SUMMER20"
           },
-          "initial_billing_run": {
-            "$ref": "#/components/schemas/V2BillingRunSummary"
+          "coupon": {
+            "type": "string",
+            "description": "Coupon id.",
+            "example": "coup_5f3a1c2b9d8e4f6a7b8c9d0e"
           },
-          "initial_billing_run_id": {
+          "active": {
+            "type": "boolean"
+          },
+          "customer": {
             "type": "integer",
-            "nullable": true
+            "nullable": true,
+            "description": "Customer id to restrict the code to. Mutually exclusive with `customer_reference`."
           },
-          "initial_billing_run_total_amount": {
+          "customer_reference": {
             "type": "string",
-            "format": "decimal",
+            "nullable": true,
+            "description": "Customer reference to restrict the code to. Mutually exclusive with `customer`."
+          },
+          "max_redemptions": {
+            "type": "integer",
+            "nullable": true,
+            "minimum": 1
+          },
+          "expires_at": {
+            "type": "string",
+            "format": "date-time",
             "nullable": true
           },
-          "latest_billing_run": {
-            "$ref": "#/components/schemas/V2BillingRunSummary"
+          "restrictions": {
+            "type": "object",
+            "nullable": true,
+            "description": "Redemption restrictions. Only a minimum order amount is supported; `minimum_amount` and `minimum_amount_currency` must be provided together, or send an empty object to remove the restriction.",
+            "properties": {
+              "minimum_amount": {
+                "type": "string",
+                "format": "decimal",
+                "description": "Minimum amount the code can be applied to. Must be greater than zero.",
+                "example": "1000"
+              },
+              "minimum_amount_currency": {
+                "type": "string",
+                "description": "Three-letter ISO 4217 code of `minimum_amount`.",
+                "example": "ISK"
+              }
+            },
+            "additionalProperties": false
+          },
+          "metadata": {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/V2Metadata"
+              }
+            ],
+            "nullable": true
           }
-        }
+        },
+        "additionalProperties": false
       }
     },
     "parameters": {
@@ -5589,6 +6564,28 @@
           "type": "string",
           "format": "uuid"
         }
+      },
+      "V2CouponId": {
+        "name": "couponId",
+        "in": "path",
+        "description": "Coupon id.",
+        "required": true,
+        "style": "simple",
+        "explode": false,
+        "schema": {
+          "type": "string"
+        }
+      },
+      "V2PromotionCodeId": {
+        "name": "promotionCodeId",
+        "in": "path",
+        "description": "Promotion code id.",
+        "required": true,
+        "style": "simple",
+        "explode": false,
+        "schema": {
+          "type": "string"
+        }
       }
     },
     "responses": {
@@ -5958,6 +6955,127 @@
           }
         }
       },
+      "V2FulfillmentOrderConflict": {
+        "description": "The order has already moved somewhere the action cannot take it from, or is moving there right now: `order_cancelled` when fulfilling a cancelled order, `order_fulfilled` when cancelling a fulfilled one, `booking_in_progress` when a shipment is being booked in Áskell for it — retry shortly",
+        "content": {
+          "application/json": {
+            "schema": {
+              "type": "object",
+              "properties": {
+                "error": {
+                  "type": "string"
+                },
+                "code": {
+                  "type": "string",
+                  "enum": [
+                    "order_cancelled",
+                    "order_fulfilled",
+                    "booking_in_progress"
+                  ]
+                }
+              }
+            }
+          }
+        }
+      },
+      "V2Coupon": {
+        "description": "V2 coupon",
+        "content": {
+          "application/json": {
+            "schema": {
+              "$ref": "#/components/schemas/V2Coupon"
+            }
+          }
+        }
+      },
+      "V2CouponList": {
+        "description": "V2 coupon list",
+        "content": {
+          "application/json": {
+            "schema": {
+              "anyOf": [
+                {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/V2Coupon"
+                  }
+                },
+                {
+                  "type": "object",
+                  "properties": {
+                    "count": {
+                      "type": "integer"
+                    },
+                    "next": {
+                      "type": "string",
+                      "nullable": true
+                    },
+                    "previous": {
+                      "type": "string",
+                      "nullable": true
+                    },
+                    "results": {
+                      "type": "array",
+                      "items": {
+                        "$ref": "#/components/schemas/V2Coupon"
+                      }
+                    }
+                  }
+                }
+              ]
+            }
+          }
+        }
+      },
+      "V2PromotionCode": {
+        "description": "V2 promotion code",
+        "content": {
+          "application/json": {
+            "schema": {
+              "$ref": "#/components/schemas/V2PromotionCode"
+            }
+          }
+        }
+      },
+      "V2PromotionCodeList": {
+        "description": "V2 promotion code list",
+        "content": {
+          "application/json": {
+            "schema": {
+              "anyOf": [
+                {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/V2PromotionCode"
+                  }
+                },
+                {
+                  "type": "object",
+                  "properties": {
+                    "count": {
+                      "type": "integer"
+                    },
+                    "next": {
+                      "type": "string",
+                      "nullable": true
+                    },
+                    "previous": {
+                      "type": "string",
+                      "nullable": true
+                    },
+                    "results": {
+                      "type": "array",
+                      "items": {
+                        "$ref": "#/components/schemas/V2PromotionCode"
+                      }
+                    }
+                  }
+                }
+              ]
+            }
+          }
+        }
+      },
       "V2BillingRun": {
         "description": "V2 billing run",
         "content": {