---
title: "Get organizations"
method: GET
path: "/rest/servicedeskapi/servicedesk/{serviceDeskId}/organization"
tags: ["Organization"]
---

# Get organizations

`GET /rest/servicedeskapi/servicedesk/{serviceDeskId}/organization`

## Request

- Base URL: `https://your-domain.atlassian.net`
- URL: `https://your-domain.atlassian.net/rest/servicedeskapi/servicedesk/{serviceDeskId}/organization`
- Auth: OAuth 2
  - Authorization code: `https://auth.atlassian.com/authorize`
  - Token URL: `https://auth.atlassian.com/oauth/token` scopes: `manage:servicedesk-customer`

This method returns a list of all organizations associated with a service desk.

**[Permissions](#permissions) required**: Service desk's agent.

## Path parameters

- `serviceDeskId` string, required

## Query parameters

- `start` integer
- `limit` integer
- `accountId` string

## Response `200`

Returns the requested organizations list.

- PagedDTOOrganizationDTO
  - `_expands` string[]
  - `_links` PagedLinkDTO
    - `base` string, uri: Base URL for the REST API calls.
    - `context` string
    - `next` string, uri: REST API URL for the next page, if there is one.
    - `prev` string, uri: REST API URL for the previous page, if there is one.
    - `self` string, uri: REST API URL for the current page.
  - `isLastPage` boolean: Indicates if this is the last page of records (true) or not (false).
  - `limit` integer: Number of items to be returned per page, up to the maximum set for these objects in the current implementation.
  - `size` integer: Number of items returned in the page.
  - `start` integer: Index of the first item returned in the page.
  - `values` OrganizationDTO[]: Details of the items included in the page.
    - `_links` SelfLinkDTO
      - `self` string, uri
    - `created` DateDTO
      - `epochMillis` integer: Date as the number of milliseconds that have elapsed since 00:00:00 Coordinated Universal Time (UTC), 1 January 1970.
      - `friendly` string: Date in a user-friendly text format.
      - `iso8601` string: Date in ISO8601 format.
      - `jira` string: Date in the format used in the Jira REST APIs, which is ISO8601 format but extended with milliseconds. For example, 2016-09-28T23:08:32.097+1000.
    - `id` string: A unique system generated ID for the organization.
    - `name` string: Name of the organization.
    - `scimManaged` boolean: Returns if an organization is managed by scim. This field may not be present in some older organizations
    - `uuid` string: A unique system generated ID for the organization. This is identity from the group directory id

## Other responses

- `401`: Returned if the user is not logged in.
- `403`: Returned if user does not have the necessary permission.
- `404`: Returned if the service desk does not exist or the user is not found.
- `500`: Internal Server Error.

## Changes

> 20 revisions in range; 3 not diffed.

- **2026-07-13** `bba7b3477d98`: 1 info
  - added the optional property `values/items/scimManaged` to the response with the `200` status
- **2024-02-08** `7c79c3ffe305`: 2 info
  - added the optional property `values/items/created` to the response with the `200` status
  - added the optional property `values/items/uuid` to the response with the `200` status

[Operation history](https://skmtc.dev/atlassian/apis/service-management-public-rest-api/changes/rest/servicedeskapi/servicedesk/:serviceDeskId/organization/get.md)

---

[API](https://skmtc.dev/atlassian/apis/service-management-public-rest-api.md) - [All operations](https://skmtc.dev/atlassian/apis/service-management-public-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/atlassian/apis/service-management-public-rest-api/revisions/fe02b1260fc7?raw)