---
title: "Check Rating Eligibility"
method: GET
path: "/api/v1/ratings/eligibility"
tags: ["Ratings", "Ratings"]
---

# Check Rating Eligibility

`GET /api/v1/ratings/eligibility`

## 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/ratings/eligibility`
- Auth: HTTP bearer

Check if user is eligible for rating bonus

Returns eligibility status and details:
- can_rate: Whether user can submit a rating
- is_bonus_applicable: Whether user will receive bonus scans
- bonus_scans: Number of bonus scans (0 or 5)
- message: User-friendly message

**Scenarios:**
- Free user, all scans used: can_rate=true, is_bonus_applicable=true, bonus_scans=5
- Free user, scans remaining: can_rate=true, is_bonus_applicable=false, bonus_scans=0
- Premium user: can_rate=true, is_bonus_applicable=false, bonus_scans=0
- Already rated: can_rate=false, is_bonus_applicable=false, bonus_scans=0

## Response `200`

Successful Response

- RatingEligibilityResponse: Response for rating eligibility check
  - `can_rate` boolean, required
  - `is_bonus_applicable` boolean, required
  - `bonus_scans` integer, required
  - `reason` string, required

---

[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)