---
title: Organizations
description: 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.
component: pingone-api
page_id: pingone-api:platform:organizations
canonical_url: https://developer.pingidentity.com/pingone-api/platform/organizations.html
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.html#automatic-role-assignment).

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

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

Refer to [Roles Management](roles.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.                                 |