---
title: "GET /api/organizations/{id}"
method: GET
path: "/api/organizations/{id}"
tags: ["Organizations"]
---

# GET /api/organizations/{id}

`GET /api/organizations/{id}`

## Request

- Base URL: `https://uptimeify.io`
- URL: `https://uptimeify.io/api/organizations/{id}`
- Auth: HTTP bearer

## Path parameters

- `id` string, required

## Response `200`

Successful response

- object: Billing, address, quota and MFA policy fields (organization admins and global admins only; absent for other roles).
  - `id` integer, required
  - `publicId` string, uuid, required
  - `name` string, required
  - `status` string, required: active or suspended.
  - `deletionDueAt` string, date-time, nullable, required: Set while a deletion request runs out its notice period.
  - `emailLanguage` string, nullable, required
  - `billingEmail` string, nullable, required: null for roles other than admin.
  - `billingCycle` string, nullable, required: monthly; null for roles other than admin.
  - `paymentMethod` string, nullable, required: invoice or mollie; null for roles other than admin.
  - `activeDiscount` object, nullable, required
    - `code` string, nullable, required: null for roles other than admin.
    - `discountPercent` number, required
    - `expiresAt` string, date-time, nullable, required
  - `defaultNotificationChannels` object, nullable, required
    - `email` boolean, required
    - `sms` boolean, required
    - `webhook` boolean, required
    - `integrations` boolean, required
  - `defaultNotificationTargets` object, nullable, required
    - `email` 'customer' | 'organization' | 'both', required
    - `sms` 'customer' | 'organization' | 'both', required
    - `webhook` 'organization', required
    - `integrations` 'customer' | 'organization' | 'both', required
  - `defaultNotificationRules` object, nullable, required
  - `requireMfaAdmins` boolean
  - `requireMfaEditors` boolean
  - `requireMfaReadonly` boolean
  - `requireMfaCustomers` boolean
  - `companyName` string, nullable
  - `street` string, nullable
  - `postalCode` string, nullable
  - `city` string, nullable
  - `country` string, nullable
  - `vatId` string, nullable
  - `discountCodeId` integer, nullable
  - `discountAppliedAt` string, date-time, nullable
  - `trialForfeited` boolean: The free trial was used and forfeited; GET only.
  - `quotaWebsitesLimit` integer, nullable
  - `quotaIpsLimit` integer, nullable
  - `quotaSmsIncluded` integer, nullable
  - `quotaMonthlyPriceCents` integer, nullable
  - `quotaExtraSmsPriceCents` integer, nullable
  - `quotaEffectiveAt` string, date-time, nullable
  - `quotaAutoUpgradeEnabled` boolean
  - `pendingQuotaChange` object, nullable: A scheduled quota reduction, effective at the end of the billing period.
    - `effectiveAt` string, date-time, required
    - `quotaWebsitesLimit` integer, nullable, required
    - `quotaSmsIncluded` integer, nullable, required
    - `quotaMonthlyPriceCents` integer, nullable, required
  - `smsOverageSafetyCapCentsMonthly` integer, nullable
  - `smsOverageCapLastAlertedPeriod` string, nullable
  - `smsOverageCapLastAlertedAt` string, date-time, nullable
  - `smsOverageCapBlockedAt` string, date-time, nullable
  - `smsOverageCapBlockedReason` string, nullable

## Other responses

- `400`: Invalid or missing parameters.
- `401`: Missing, invalid or expired API token.
- `404`: No such resource, or not visible to this token.
- `500`: Unexpected server error.

---

[API](https://skmtc.dev/uptimeify/apis/uptimeify-rest-api.md) · [All operations](https://skmtc.dev/uptimeify/apis/uptimeify-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/uptimeify/apis/uptimeify-rest-api/revisions/2129a771ee7e?raw)