---
title: "Preview Promo Code"
method: GET
path: "/api/v1/promo/{code}"
tags: ["Promo Codes"]
---

# Preview Promo Code

`GET /api/v1/promo/{code}`

## Request

- Base URL: `https://api.gemstoneaiapp.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.gemstoneaiapp.com/api/v1/promo/{code}`
- Auth: none declared

Check a code before signing up. Rate limited — this is a guessable surface.

## Path parameters

- `code` string, required

## Response `200`

Successful Response

- PromoPreviewResponse
  - `code` string, required
  - `valid` boolean, required
  - `premium_days` integer, nullable
  - `bonus_scans` integer
  - `requires_matching_email` boolean
  - `message` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/gemstoneaiapp/apis/gemstoneai-api.md) · [All operations](https://skmtc.dev/gemstoneaiapp/apis/gemstoneai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/gemstoneaiapp/apis/gemstoneai-api/revisions/fcb441f55161?raw)