---
title: "GET /api/coupon/{code}/info"
method: GET
path: "/api/coupon/{code}/info"
tags: ["api", "coupons"]
---

# GET /api/coupon/{code}/info

`GET /api/coupon/{code}/info`

Get Coupon or Voucher by code

## Path parameters

- `code` string, required — The code of the coupon/voucher

## Query parameters

- `sellerId` string, required — The ID of the seller
- `eventId` string — The ID of the event to check the coupon/voucher against.

## Response `200`

OK

- GETCouponsGetCouponOrVoucherByCode200Response
  - `message` 'notYetValid' | 'expired' | 'invalid' | 'valid' | 'unauthenticated', required — The status of the coupon/voucher.
  - `coupon` object
    - `code` string, required — The code of the coupon.
    - `couponId` string, required — The ID of the coupon.
    - `name` string, required — The Name for the coupon. Visible to public.
    - `canBeCombined` boolean — Whether this coupon can be combined with others within one transaction.
    - `discountType` 'fix' | 'var' | 'fixPerItem' | 'waiveFees'
    - `discountValue` number, float — The amount of the discount in seller's currency. eg. 50.0 -> 50 EUR
    - `discountMaxValue` number, float, nullable — When discountType is VAR the max amount of the discount in seller's currency
    - `allowAllTickets` boolean — Whether the coupon can be used across all tickets within the events
    - `allowedTickets` string[] — The ID's of the ticket types on which the coupon should be applied
    - `allowAllEvents` boolean — Whether the coupon can be used across all events
    - `limitMaxTicketsInCart` boolean — Whether this coupon limits the max tickets in cart.
    - `maxTicketsInCart` number, float, nullable — If limitMaxTicketsInCart is true, the amount of the max allowed tickets.
    - `minTicketsInCart` number, float, nullable — The minimum number of tickets that need to be purchased with this coupon
    - `maxTickets` number, float, nullable — The number of tickets that can be purchased with this coupon
    - `revealAllowedTickets` boolean — Whether this coupon reveals the allowed tickets.
  - `voucher` object
    - `_id` string, required — The ID of the voucher.
    - `code` string, required — The code of the voucher.
    - `balance` number, float — The available balance on the voucher.
  - `type` 'voucher' | 'coupon' — The type of resource.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found

---

[API](https://skmtc.net/vivenu/apis/vivenu-api.md) · [All operations](https://skmtc.net/vivenu/apis/vivenu-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vivenu/vivenu-api/revisions/36be0dca14e7/schema)