Unuse Coupon

Item	Value
Description	This API endpoint allows clients to mark a coupon as “unused”, available to be used again.
Method	POST
Endpoint	https://[environment]api[client_id].crowdtwist.com/v2/coupon/unuse?api_key=[api_key]
Content Type	application/json

Request Body

Field Name	Sample Value	Required	Format	Description
coupon_value	1X3FJ9K003	Yes	String	The value of the coupon being updated.

Response Body

Field Name	Sample Value	Required	Format	Description
success	true	Yes	Boolean	True if the request was successful.
message	Successfully submitted	Yes	String	Response message for this request.

Error Responses

Field Name	Sample Value	Required	Format	Description
error	internal_error	Yes	String	The identifier of the category of the error. This gives the client the ability to categorize errors and make assumptions based on the identifier of the error.
message	Coupon could not be found	Yes	String	This is a detailed message around the error specifying, as specifically as possible, what the fields are that are missing or where exactly the error is.

Error Response Codes

Error	Error Code	Description	Reason
Input Error	4xx	Returned whenever the request is missing required fields, including situations in which the body is malformed (e.g. HTTP method not supported, receipt not found, etc.).	– not_used – not_issued – no_data
Server Error	5xx	HTTP error status code is returned due to an error that occurred in the backend.	–internal_error: unexpected error occurred in the CrowdTwist backend – not_configured: error occurs when an configuration has not been configured yet

Example Response Codes

Sample Request

{"coupon_value": "JDSI2JE"}

Sample Response Body

{ "success": true, "message": "Successfully submitted coupon [ABC123] to be marked as unused." }

Sample Error Responses

{ "error": "no_data", "message": "Unable to find coupon." }

{ "error": "not_issued", "message": "Coupon has not been issued." }

{ "error": "not_used", "message": "Coupon has not been used." }