# Update a virtual coupon

### PU&#x54;**:** /wp-json/coupons/v1/virtualcoupons/‌{virtual\_coupon\_id} <a href="#post-wp-json-loyalty-program-v-1-customers-points-user_id" id="post-wp-json-loyalty-program-v-1-customers-points-user_id"></a>

{% tabs %}
{% tab title="Request" %}
**Requirements:**

* Logged-in user
* user role with `manage_woocommerce` user capability

| Method | Endpoint                                                  |
| ------ | --------------------------------------------------------- |
| PUT    | /wp-json/coupons/v1/virtualcoupons/‌{virtual\_coupon\_id} |

| Query Parameters | Required | Type    | Description                                               |
| ---------------- | -------- | ------- | --------------------------------------------------------- |
| status           | no       | string  | Valid virtual coupon status: `pending` or `used`          |
| date\_created    | no       | string  | Date and time of virtual coupon was created               |
| date\_expire     | no       | string  | Date and time for virtual coupon to be marked as expired. |
| user\_id         | no       | integer | Customer ID                                               |
| date\_format     | no       | string  | Date format of the provided date values                   |
| {% endtab %}     |          |         |                                                           |

{% tab title="Request Example" %}
Update virtual coupon status

```
PUT: http://example.com/wp-json/coupons/v1/virtualcoupons/‌467

JSON Body:
{
    "status": "used"
}
```

Update virtual coupon status and date expire

```
PUT: http://example.com/wp-json/coupons/v1/virtualcoupons/‌467

JSON Body:
{
    "status": "used",
    "date_expire": "January 1, 2022 10:00 am",
    "date_format": "F j, Y g:i a"
}
```

{% endtab %}

{% tab title="Response Example" %}
**Status: 200 OK**

Update virtual coupon status

```
{
  "message": "Successfully updated virtual coupon.",
  "data": {
    "key": "467",
    "id": 467,
    "code": "S4WXTUG8DT",
    "main_code": "bogo1",
    "coupon_code": "bogo1-s4wxtug8dt",
    "status": "used",
    "coupon_id": 207,
    "user_id": 0,
    "user_fullname": "",
    "user_email": "",
    "date_created": "June 28, 2021 1:48 pm",
    "date_expire": ""
  }
}
```

Update virtual coupon status and date expire

```
{
  "message": "Successfully updated virtual coupon.",
  "data": {
    "key": "467",
    "id": 467,
    "code": "S4WXTUG8DT",
    "main_code": "bogo1",
    "coupon_code": "bogo1-s4wxtug8dt",
    "status": "used",
    "coupon_id": 207,
    "user_id": 0,
    "user_fullname": "",
    "user_email": "",
    "date_created": "June 28, 2021 1:48 pm",
    "date_expire": "January 1, 2022 10:00 am"
  }
}
```

**Status: 403 Forbidden**

```
{
    "code": "rest_forbidden_context",
    "message": "Sorry, you are not allowed access to this endpoint.",
    "data": {
        "status": 401
    }
}
```

{% endtab %}
{% endtabs %}