get https://www.ted.hover.com/api/vouchers/
The :id parameter is either the voucher id or a voucher code (but not the redemption_url) of a voucher.
Voucher States:
valid, which is the starting state for all vouchers,redeemedwhen a user has bought a domain with the voucher,expiredwhen the voucher reaches its expiry date without being usedcancelledafter you have invokedcancelon the voucher.
Voucher fields:
id: the string you will normally use to identify the voucher with the API.state: one of the four states listed abovecreated_at: the ISO8601 time when the voucher was createdfirst_viewed_at: if notnull, this is the ISO8601 time when the voucher link was first viewedcancelled_at: if notnull, the ISO8601 time when you cancelled the voucherexpires_at: the time the voucher will expire if not used. Vouchers always have an expiry time, and you can control it when you create the voucher, via thedays_validparameter.config: if you have multiple voucher configurations, this is the name of the configuration the voucher was issued under.partner_price: the amount (in US dollars) Hover will charge you when the voucher is used.tlds: a space-separated list of domain extensions the voucher can be used with.callback_url: a URL where you can be notified when a voucher has been successfully redeemed.metadata: returned only if stored with the Voucher at the time the Voucher was created, and optionally available on a per Partner basis by request.
Note that the following fields are null until the voucher is redeemed:
hover_order_id: The ID of the order in Hover's database (e.g.,2736101)domain_name: The domain name the voucher was used for. (Note that a customer may buy more than one domain in the order, but only one of them is associated with the voucher).redeemed_at: The ISO8601 time when the order was completedhover_username: The user's Hover usernameconnect_param_value: If you are sending a parameter to auto-configure the user's domain on Hover's DNS servers, this is the value you sent us.domain_expires_on: The date the domain will expire if not renewed in yyyy-mm-dd format.connected: Whether the domain is connected via your Connect template. Eithertrueorfalse.
