---
title: "Fetch current account entitlements"
method: GET
path: "/v1/accounts/me/entitlements"
tags: ["Accounts"]
---

# Fetch current account entitlements

`GET /v1/accounts/me/entitlements`

## Request

- Base URL: `https://api.checklyhq.com`
- URL: `https://api.checklyhq.com/v1/accounts/me/entitlements`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/checklyhq/apis/checkly-public-api/docs/v1/accounts/me/entitlements/get.ts> (a function with typed inputs; its response is checked against the schema)

Fetch the entitlements for the account, including feature access and limits based on the current plan.

## Headers

- `x-checkly-account` string: Your Checkly account ID, you can find it at https://app.checklyhq.com/settings/account/general

## Response `200`

Successful

- Entitlements
  - `plan` string, required: The account plan type.
  - `planDisplayName` string: The human-readable display name of the account plan.
  - `addons` AccountAddons: The add-ons available to the account.
    - `communicate` AccountAddonTier
      - `tier` 'hobby' | 'starter' | 'team': The add-on tier.
      - `tierDisplayName` string: The human-readable display name of the add-on tier.
    - `resolve` AccountAddonTier
      - `tier` 'hobby' | 'starter' | 'team': The add-on tier.
      - `tierDisplayName` string: The human-readable display name of the add-on tier.
  - `locations` AccountEntitlementLocations, required: Check run locations and limits for this account.
    - `all` AccountEntitlementLocation[], required: All Checkly locations with availability for this account.
      - `id` string, required: Location identifier (e.g. us-east-1).
      - `name` string, required: Human-readable location name (e.g. N. Virginia).
      - `available` boolean, required: Whether this location is available on the current plan.
    - `maxPerCheck` integer: Maximum locations selectable per check. Absent when unlimited.
  - `entitlements` AccountEntitlement[], required: List of entitled features for this account.
    - `key` string, required: Unique entitlement identifier.
    - `name` string, required: Human-friendly display name.
    - `description` string, required: Short description of what this entitlement controls.
    - `type` 'flag' | 'metered', required: Whether this entitlement is a boolean feature flag or a metered resource with a quantity limit.
    - `enabled` boolean, required: Whether this entitlement is available on the current plan.
    - `quantity` integer: Maximum allowed quantity. Only present for metered entitlements.
    - `requiredPlan` string: The minimum plan required to unlock this entitlement. Only present for disabled entitlements.
    - `requiredPlanDisplayName` string: Human-readable name of the required plan.
    - `requiredAddon` AccountRequiredAddon: The addon and tier required to unlock this entitlement. Only present for disabled entitlements.
      - `name` string, required: The addon name.
      - `displayName` string, required: Human-readable addon name.
      - `tier` 'hobby' | 'starter' | 'team', required: The minimum addon tier required (e.g. starter, team).
      - `tierDisplayName` string, required: Human-readable addon tier name.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `429`: Too Many Requests

## Changes

- **2026-10-31** `bc90d1bfa738`: 1 info
  - added the optional property `errorCode` to the response with the `403` status

[Operation history](https://skmtc.dev/checklyhq/apis/checkly-public-api/changes/v1/accounts/me/entitlements/get.md)

---

[API](https://skmtc.dev/checklyhq/apis/checkly-public-api.md) - [All operations](https://skmtc.dev/checklyhq/apis/checkly-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/checklyhq/apis/checkly-public-api/revisions/bc90d1bfa738?raw)