---
title: "Get organization subscription"
method: GET
path: "/api/v2/org/{id}/subscription"
tags: ["org"]
---

# Get organization subscription

`GET /api/v2/org/{id}/subscription`

## Request

- Base URL: `https://central.zerotier.com`
- URL: `https://central.zerotier.com/api/v2/org/{id}/subscription`
- Auth: HTTP bearer

Returns the current subscription plan and feature entitlements for an organization.

## Path parameters

- `id` string, required

## Response `200`

Subscription details for the organization

- Subscription
  - `id` string, required
  - `plan` 'plan-zt1-basic' | 'plan-zt1-essential' | 'plan-zt1-scale' | 'plan-zt1-premium', required
  - `planDisplayName` string, required
  - `status` 'active' | 'in-trial' | 'past-due', required
  - `entitlements` SubscriptionEntitlements, required
    - `admins` NumericEntitlement, required
      - `value` integer, required
      - `max` integer, required: Maximum allowed
      - `kind` 'numeric-hard-cap' | 'numeric-soft-cap', required
      - `hasUnlimitedUsage` boolean, required: True if unlimited usages allowed.
      - `resetPeriod` 'hourly' | 'daily' | 'weekly' | 'monthly' | 'yearly'
      - `resetsWhen` string, date-time
    - `devices` NumericEntitlement, required
      - `value` integer, required
      - `max` integer, required: Maximum allowed
      - `kind` 'numeric-hard-cap' | 'numeric-soft-cap', required
      - `hasUnlimitedUsage` boolean, required: True if unlimited usages allowed.
      - `resetPeriod` 'hourly' | 'daily' | 'weekly' | 'monthly' | 'yearly'
      - `resetsWhen` string, date-time
    - `networks` NumericEntitlement, required
      - `value` integer, required
      - `max` integer, required: Maximum allowed
      - `kind` 'numeric-hard-cap' | 'numeric-soft-cap', required
      - `hasUnlimitedUsage` boolean, required: True if unlimited usages allowed.
      - `resetPeriod` 'hourly' | 'daily' | 'weekly' | 'monthly' | 'yearly'
      - `resetsWhen` string, date-time
    - `networkGroups` NumericEntitlement, required
      - `value` integer, required
      - `max` integer, required: Maximum allowed
      - `kind` 'numeric-hard-cap' | 'numeric-soft-cap', required
      - `hasUnlimitedUsage` boolean, required: True if unlimited usages allowed.
      - `resetPeriod` 'hourly' | 'daily' | 'weekly' | 'monthly' | 'yearly'
      - `resetsWhen` string, date-time
    - `customRoutes` BooleanEntitlement, required
      - `value` boolean, required
      - `kind` 'boolean', required
    - `customDns` BooleanEntitlement, required
      - `value` boolean, required
      - `kind` 'boolean', required
    - `flowRulesCustom` BooleanEntitlement, required
      - `value` boolean, required
      - `kind` 'boolean', required
    - `flowRulesTemplates` BooleanEntitlement, required
      - `value` boolean, required
      - `kind` 'boolean', required
    - `publicNetworks` BooleanEntitlement, required
      - `value` boolean, required
      - `kind` 'boolean', required
    - `fullRebac` BooleanEntitlement, required
      - `value` boolean, required
      - `kind` 'boolean', required
    - `serviceAccounts` NumericEntitlement, required
      - `value` integer, required
      - `max` integer, required: Maximum allowed
      - `kind` 'numeric-hard-cap' | 'numeric-soft-cap', required
      - `hasUnlimitedUsage` boolean, required: True if unlimited usages allowed.
      - `resetPeriod` 'hourly' | 'daily' | 'weekly' | 'monthly' | 'yearly'
      - `resetsWhen` string, date-time
    - `api` NumericEntitlement, required
      - `value` integer, required
      - `max` integer, required: Maximum allowed
      - `kind` 'numeric-hard-cap' | 'numeric-soft-cap', required
      - `hasUnlimitedUsage` boolean, required: True if unlimited usages allowed.
      - `resetPeriod` 'hourly' | 'daily' | 'weekly' | 'monthly' | 'yearly'
      - `resetsWhen` string, date-time
    - `webhooks` NumericEntitlement, required
      - `value` integer, required
      - `max` integer, required: Maximum allowed
      - `kind` 'numeric-hard-cap' | 'numeric-soft-cap', required
      - `hasUnlimitedUsage` boolean, required: True if unlimited usages allowed.
      - `resetPeriod` 'hourly' | 'daily' | 'weekly' | 'monthly' | 'yearly'
      - `resetsWhen` string, date-time

## Other responses

- `401`: Missing or invalid authentication token
- `403`: Insufficient permissions
- `500`: Internal server error

---

[API](https://skmtc.dev/zerotier/apis/zerotier-central-v2-api.md) - [All operations](https://skmtc.dev/zerotier/apis/zerotier-central-v2-api/llms.txt) - [OpenAPI document](https://skmtc.dev/zerotier/apis/zerotier-central-v2-api/revisions/b2e7468ad104?raw)