▲HIGHLAND DOCS

Coupons

A coupon code adds free credits to your balance. Credits work everywhere: every API, MCP tools, chat and Obsidian. Codes are handed out at events, in newsletters, by partners and by support.

Redeem a code

On the buy page, paste the code in Coupon code and tap Redeem. Over the API:

bash
curl -s https://api.highlnd-intel.group/v1/coupons/redeem \
  -H "authorization: Bearer $HIGHLAND_KEY" \
  -H "content-type: application/json" \
  -d '{"code": "LAUNCH-500"}'
json
{ "code": "LAUNCH-500", "creditCents": 500, "balanceCents": 500 }

Codes are not case-sensitive (launch-500 works) and are 4 to 32 letters, digits or dashes.

Rules

  • One redemption per code per account.
  • A code can have a total use limit, an expiry date, or be limited to new accounts (created after the code).
  • Coupon credits are a gift: they never count as a purchase, so they do not start a plan or pay a referral reward.
  • Redeeming is rate-limited per account to stop code guessing.

Errors

StatusErrorMeaning
400invalid_codeNot a valid code format.
404coupon_not_foundNo such code. Check for typos.
409already_redeemedThis account already used it.
410coupon_expiredPast its end date.
410coupon_used_upAll uses are taken.
410coupon_disabledTurned off by the owner.
403new_accounts_onlyOnly accounts created after the code was made can use it.
429rate_limitedToo many tries. Wait a minute.

In an agent

python
import os, requests
r = requests.post("https://api.highlnd-intel.group/v1/coupons/redeem",
                  headers={"authorization": f"Bearer {os.environ['HIGHLAND_KEY']}"},
                  json={"code": os.environ["HIGHLAND_COUPON"]}, timeout=30)
print(r.status_code, r.json())