<!--
{
  "availability" : [

  ],
  "documentType" : "symbol",
  "framework" : "apple-school-and-business-manager-api",
  "identifier" : "/documentation/AppleBusinessAPI/Get-Organizational-Units",
  "metadataVersion" : "0.1.0",
  "role" : "Web Service Endpoint",
  "symbol" : {
    "kind" : "Web Service Endpoint",
    "modules" : [
      "Apple Business API"
    ],
    "preciseIdentifier" : "rest:AppleBusinessAPI:get:v1-organizationalUnits"
  },
  "title" : "Get Organizational Units"
}
-->

# Get Organizational Units

Get a list of organizational units in an organization.

## Overview

### Example

**Request:**

```
curl "https://api-business.apple.com/v1/organizationalUnits" \
    -H "Authorization: Bearer ${ACCESS_TOKEN}"
```

**Response:**

```json
    {
    "data": [
      {
        "type": "organizationalUnits",
        "id": "OU789012",
        "attributes": {
          "name": "Engineering",
          "description": "Engineering organizational unit",
          "createdDateTime": "2023-03-15T10:00:00Z",
          "updatedDateTime": "2024-06-01T14:30:00Z"
        },
        "relationships": {
          "users": {
            "links": {
              "self": "https://api-business.apple.com/v1/organizationalUnits/OU789012/relationships/users"
            }
          }
        },
        "links": {
          "self": "https://api-business.apple.com/v1/organizationalUnits/OU789012"
        }
      }
    ],
    "links": {
      "self": "https://api-business.apple.com/v1/organizationalUnits",
      "next": "https://api-business.apple.com/v1/organizationalUnits?cursor=MDowOjE3NDYxMTM4OTI1OTA6MTc0NjExMzg5MjU5MDp0cnVlOmZhbHNlOjE3NDYxMTM4OTI1OTA"
    },
    "meta": {
      "paging": {
        "nextCursor": "MDowOjE3NDYxMTM4OTI1OTA6MTc0NjExMzg5MjU5MDp0cnVlOmZhbHNlOjE3NDYxMTM4OTI1OTA",
        "limit": 100
      }
    }
  }
```

## Topics

### Responses

[`object OrganizationalUnitsResponse`](/documentation/AppleBusinessAPI/OrganizationalUnitsResponse)

A response that contains a list of organizational unit resources.


---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)