Skip to main content
POST
Redeem a free Premium code
An account already paying through Stripe gets the free months after its paid period, with nothing charged; Stripe bills again by itself afterwards. A code is single use, and an account gets each offer once; repeating your own redemption answers the same. An unknown, used, revoked or expired code, or an offer the account already had, is invalid_code; five of those in an hour wait an hour (redeem_throttled). While a free period runs another code is promotion_already_active and stays unused.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
code
string
required

The code as sent, such as ABCD-EFGH-JKMN-PQRS; case, dashes and spaces are ignored, and I and L read as 1, O as 0

Required string length: 1 - 64

Response

The free Premium period

status
enum<string>
required
Available options:
redeemed
promotion
object
required