---
title: "Get Entitlement"
method: GET
path: "/api/billing/entitlement"
tags: ["Billing"]
---

# Get Entitlement

`GET /api/billing/entitlement`

## Request

- Base URL: `https://api.earmarkiq.app` (the document declares no server; this is the origin it was published from)
- URL: `https://api.earmarkiq.app/api/billing/entitlement`
- Auth: HTTP bearer

Effective tier and which source granted it, so Settings can point the
user at the right place to manage or cancel.

## Response `200`

Successful Response

- EntitlementResponse
  - `tier` string, required
  - `source` 'apple' | 'stripe' | 'sponsored' | 'grant' | 'none', required

## Changes

- **2026-10-19** `4a2c41907105`: 1 warning
  - added the new `grant` enum value to the `source` response property for the response status `200`

[Operation history](https://skmtc.dev/earmarkiq/apis/earmark-api/changes/api/billing/entitlement/get.md)

---

[API](https://skmtc.dev/earmarkiq/apis/earmark-api.md) · [All operations](https://skmtc.dev/earmarkiq/apis/earmark-api/llms.txt) · [OpenAPI document](https://skmtc.dev/earmarkiq/apis/earmark-api/revisions/4a2c41907105?raw)