---
title: "Get organization"
method: GET
path: "/organizations/{organization_id}"
tags: ["Organizations"]
---

# Get organization

`GET /organizations/{organization_id}`

Retrieves the specified organization.

## Path parameters

- `organization_id` string, required

## Response `200`

OK

- Organization
  - `id` string, ulid — The ID of the organization.
  - `type` 'fixed' | 'flexible' — The type of the organization.
  - `owner_id` string, uuid — The ID of the owner.
  - `namespace` string — The namespace in which the organization name is unique.
  - `name` string — A unique machine name representing the organization.
  - `label` string — The human-readable label of the organization.
  - `country` string — The organization country (2-letter country code).
  - `capabilities` string[] — The organization capabilities.
  - `vendor` string — The vendor.
  - `billing_account_id` string — The Billing Account ID.
  - `billing_legacy` boolean — Whether the account is billed with the legacy system.
  - `security_contact` string, email — The security contact email address for the organization.
  - `status` 'active' | 'restricted' | 'suspended' | 'deleted' — The status of the organization.
  - `created_at` string, date-time — The date and time when the organization was created.
  - `updated_at` string, date-time — The date and time when the organization was last updated.
  - `_links` object
    - `self` object — Link to the current organization.
      - `href` string — URL of the link.
    - `update` object — Link for updating the current organization.
      - `href` string — URL of the link.
      - `method` string — The HTTP method to use.
    - `delete` object — Link for deleting the current organization.
      - `href` string — URL of the link.
      - `method` string — The HTTP method to use.
    - `members` object — Link to the current organization's members.
      - `href` string — URL of the link.
    - `create-member` object — Link for creating a new organization member.
      - `href` string — URL of the link.
      - `method` string — The HTTP method to use.
    - `address` object — Link to the current organization's address.
      - `href` string — URL of the link.
    - `profile` object — Link to the current organization's profile.
      - `href` string — URL of the link.
    - `payment-source` object — Link to the current organization's payment source.
      - `href` string — URL of the link.
    - `orders` object — Link to the current organization's orders.
      - `href` string — URL of the link.
    - `vouchers` object — Link to the current organization's vouchers.
      - `href` string — URL of the link.
    - `apply-voucher` object — Link for applying a voucher for the current organization.
      - `href` string — URL of the link.
      - `method` string — The HTTP method to use.
    - `subscriptions` object — Link to the current organization's subscriptions.
      - `href` string — URL of the link.
    - `create-subscription` object — Link for creating a new organization subscription.
      - `href` string — URL of the link.
      - `method` string — The HTTP method to use.
    - `estimate-subscription` object — Link for estimating the price of a new subscription.
      - `href` string — URL of the link.
    - `mfa-enforcement` object — Link to the current organization's MFA enforcement settings.
      - `href` string — URL of the link.

## Other responses

- `403` — Forbidden
- `404` — Not Found

---

[API](https://skmtc.net/upsun/apis/upsun-com-rest-api.md) · [All operations](https://skmtc.net/upsun/apis/upsun-com-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/upsun/upsun-com-rest-api/revisions/6cc88fde6435/schema)