Themes built on the Twig templating engine are now deprecated and require migration to Vitrin to ensure continued support and compatibility with Zid.

Update Coupon Status

PUT

https://api.zid.sa/v1/managers/store/coupon/{coupon-id}/status

This endpoint allows merchants to update the status of an existing coupon.

🔑Scopes

third_coupons_write - Coupons Write

Request

Path Params

Header Params

Body Params application/x-www-form-urlencoded

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PUT 'https://api.zid.sa/v1/managers/store/coupon/6351724/status' \
--header 'Authorization: {{Autherization}}' \
--header 'X-Manager-Token: {{Access-Token}}' \
--header 'Accept: application/json' \
--header 'Accept-Language: en' \
--data-urlencode 'status=1'

Responses

🟢200OK

application/json

Bodyapplication/json

Example

{
    "status": "object",
    "coupon": {
        "coupon_id": 6351724,
        "id": 6351724,
        "store_id": 3,
        "store_name": "متجر أسامة.",
        "store_logo": null,
        "code": "SUMMER20262-copy-2-c",
        "uses_total": 1000,
        "created_at": "2026-06-22T12:15:27.000000Z",
        "name": "Copy 1 of Copy 2 of Summer Sale 2 - July 2026",
        "total_usage": null,
        "discount_type": "f",
        "applying_method": "CODE",
        "discount_strategy": "standard",
        "progressive_config": null,
        "conditions": [
            {
                "field": "customer_location",
                "operator": "=",
                "action": "INCLUDE",
                "value": "1"
            }
        ],
        "conditions_criteria": "all",
        "discount": 155,
        "logged": false,
        "free_shipping": false,
        "free_cod": false,
        "apply_to": "all",
        "total": 0,
        "max_total": 0,
        "max_weight": 0,
        "date_start": "2021-02-10",
        "date_end": "2021-02-28",
        "uses_customer": 1000,
        "coupon_status": true,
        "status_code": "coupon_expired",
        "maximum_discount_value": null,
        "orders": [],
        "total_sales": 0,
        "total_customers": 0,
        "note": null,
        "is_mazeed_active": true,
        "is_pos_active": true,
        "is_shown_in_pos": true,
        "is_mobile_app_active": true,
        "is_manageable": false,
        "is_active": false,
        "enabled": false,
        "apply_to_data": []
    },
    "message": {
        "type": "object",
        "code": null,
        "name": null,
        "description": null
    }
}

🟠401Unauthorized

🟠422Validation Error

🔴500Internal Server error

Modified at 2026-06-22 14:26:13

Update Bulk Coupons

Update Bulk Coupons Status