Returns FREE, LOCKED or NOT_FOUND only. The request identifies the list by couponListName within the authenticated customer. The supplied code is never returned. This operation does not reserve or consume a code.
List and coupon code to check.
List name in the authenticated customer; case-insensitive, 3-50 characters.
Coupon code to look up; non-blank, at most 200 characters. Never returned in responses or errors.
FREE, LOCKED or NOT_FOUND.
InvalidParameterException / INVALID_PARAMETER: request body is missing, code is null or blank, code exceeds 200 characters, or couponListName length is outside 3-50 characters; MISSING_PARAMETER: couponListName is omitted.
NoSuchObjectException / NO_SUCH_OBJECT: no list with this name exists in the authenticated customer. An absent code in an accessible list returns the successful status NOT_FOUND instead.
UnexpectedErrorException / PERMISSION_DENIED: caller lacks read access to this list. Errors never include the submitted coupon code.
UnexpectedErrorException / UNEXPECTED_ERROR: a backend operation failed; errorActor is SERVER. Errors never include the submitted coupon code.