---
title: "Check Eligibility"
method: GET
path: "/v1/demo/eligibility"
tags: ["Demo Numbers", "Demo Numbers"]
---

# Check Eligibility

`GET /v1/demo/eligibility`

## Request

- Base URL: `https://api.call2me.app`
- URL: `https://api.call2me.app/v1/demo/eligibility`
- Auth: HTTP bearer

Check whether the user can reserve a demo number.

Eligibility rules (must all be true):
  - User has NOT used their demo before
  - User has NOT made a paid topup (paid users buy real numbers)
  - No active reservation currently

Note: "has paid" users can still reserve, but they're encouraged to buy.
We don't block them — they can demo if they choose. But UI shows "Buy Number"
as primary for paid users.

## Response `200`

Successful Response

- EligibilityResponse: Whether the user can reserve a demo.
  - `eligible` boolean, required
  - `reason` string, nullable
  - `has_paid_topup` boolean, required
  - `has_used_demo` boolean, required
  - `active_reservation_id` string, nullable

---

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