---
title: Organizations
description: Read PingOne organization resources, the top-level tenant identifier that defines your enterprise within the PingOne platform
component: pingone-api
page_id: pingone-api:platform:organizations/index
canonical_url: https://developer.pingidentity.com/pingone-api/platform/organizations/index.html
llms_txt: https://developer.pingidentity.com/pingone-api/llms.txt
docs_for_agents: https://developer.pingidentity.com/build-with-ai/docs-for-agents.md
revdate: 2026-08-11
section_ids:
  assigning-admin-roles-and-permissions-to-this-service: Assigning admin roles and permissions to this service
  organzations-data-model: Organzations data model
  organizations-events-generated: Organizations events generated
  response-codes: Response codes
---

# Organizations

PingOne uses an organization-based model to define tenant accounts and their related entities. The organization is the top-level identifier. It defines your entire enterprise within the PingOne platform. The organizations endpoints provide functions to read organizations resources.

Learn more about organizations in [Introduction to PingOne](https://docs.pingidentity.com/pingone/introduction_to_pingone/p1_introduction.html), in the PingOne Admin Guide.

## Assigning admin roles and permissions to this service

Admin role assignments determine access to PingOne APIs. When assigning admin roles to this service, refer to [PingOne Permissions by Service](../reference/roles-and-permissions-in-pingone/permissions-by-service.html) for the service-specific permissions.

You can also choose to assign admin roles based on particular service resources. Refer to [PingOne Permissions by Resource](../reference/roles-and-permissions-in-pingone/permissions-by-resource.html) when assigning admin roles per service resources.

Admin assignments to roles are set by:

* [Automatic assignment for some roles](../roles/predefined-roles/index.html#automatic-role-assignment).

* [Group Role Assignments](../group-role-assignments/group-role-assignments.html).

* [User Role Assignments](../users/user-role-assignments/index.html).

Refer to [Roles Management](../roles/index.html) for more information.

## Organzations data model

| Property                | Type   | Required | Mutable   | Description                                                                                                                                                    |
| ----------------------- | ------ | -------- | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `createdAt`             | Date   | N/A      | Read-only | The time the resource was created.                                                                                                                             |
| `description`           | String | Optional | Mutable   | The description of the organization.                                                                                                                           |
| `id`                    | String | Required | Immutable | The resource's unique identifier.                                                                                                                              |
| `name`                  | String | Required | Mutable   | The organization name, which must be provided and must be unique among all organizations in PingOne.                                                           |
| `billingConnections.id` | String | Required | Immutable | The list of the BillingConnection resource IDs for the organization.                                                                                           |
| `type`                  | String | Required | Mutable   | The organization type. If the organization has any paid licenses, the `type` property value is set to `PAID`. Otherwise, the property value is set to `TRIAL`. |
| `updatedAt`             | Date   | N/A      | Read-only | The time the resource was last updated.                                                                                                                        |

## Organizations events generated

Refer to [Audit Reporting Events](../reference/audit-reporting-events.html) for the events generated.

### Response codes

| Code | Message                                                               |
| ---- | --------------------------------------------------------------------- |
| 200  | Successful operation.                                                 |
| 400  | The request could not be completed.                                   |
| 401  | You do not have access to this resource.                              |
| 403  | You do not have permissions or are not licensed to make this request. |
| 404  | The requested resource was not found.                                 |