---
title: "Returns if found a coupon based on the given coupon code."
method: GET
path: "/v1/pvt/Coupons/{code}"
tags: ["Coupons"]
---

# Returns if found a coupon based on the given coupon code.

`GET /v1/pvt/Coupons/{code}`

## Path parameters

- `code` string, required

## Response `200`

- BaseExternalApiResponseOfCreateCouponResponse — Standard response envelope used by the External API.
  - `ErrorMessage` string, nullable — Error message returned when the request fails validation or processing. For warnings and successful responses, consumers should usually inspect `Result`, `Code` and `Severity` first.
  - `ErrorCode` integer, nullable — Legacy numeric error code derived from internal API errors when available. This field is relevant only for error flows that use `ApiResponseErrorDescription`.
  - `Result` CreateCouponResponse — Create Coupon Response Model
    - `CouponCode` string — Coupon Code
    - `CreatedDate` string, date-time — Create Date
    - `IsUsed` boolean, nullable — if true the coupon was already bein use or inactivated.
    - `CouponValue` number — Discount value for the coupon
    - `CustomerId` integer — the customer that the coupon is being given.
    - `ValidDateStart` string, date-time, nullable — Date the coupon is start to being enable for rewards
    - `ValidDateEnd` string, date-time, nullable — Date the coupon will not be able for rewards anymore.
    - `CouponType` 0 | 1 | 2 | 3 | 4 — 0 = FixedValue 1 = Percent 2 = FreeShipping 3 = DiscountShipping 4 = Others
  - `Code` string, nullable — Endpoint-specific business code formatted as a two-digit string, such as `03` or `07`. This field is available for success, warning and error outcomes.
  - `CodeName` string, nullable — Symbolic enum name associated with `Code`, such as `CheckoutNotFound`.
  - `Severity` 0 | 1 | 2 — 0 = Success 1 = Warning 2 = Error
  - `HasWarning` boolean — Convenience flag that is `true` when `Severity` is `Warning`. Warnings are valid `200 OK` business outcomes and should not be handled as transport or validation errors.
  - `HasError` boolean — Indicates whether the request failed and should be handled as an error response. This flag is reserved for real API errors; warnings must keep this property as `false`.

---

[API](https://skmtc.net/bonifiq/apis/bonifiq-private-apis.md) · [All operations](https://skmtc.net/bonifiq/apis/bonifiq-private-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bonifiq/bonifiq-private-apis/revisions/070a57eeffdc/schema)