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

# Get organizations

`GET /rest/servicedeskapi/organization`

This method returns a list of organizations in the Jira Service Management instance. Use this method when you want to present a list of organizations or want to locate an organization by name.

**[Permissions](#permissions) required**: Any. However, to fetch organizations based on `accountId` the user must have a Service Desk agent license.

**Response limitations**: If the user is a customer, only those organizations of which the customer is a member are listed.

## Query parameters

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

## Response `200`

Returns paginated list of organizations.

- 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 the user does not have the necessary permission.
- `404` — Returned if the user is not found.
- `500` — Internal Server Error.

---

[API](https://skmtc.net/atlassian/apis/service-management-public-rest-api.md) · [All operations](https://skmtc.net/atlassian/apis/service-management-public-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/atlassian/service-management-public-rest-api/versions/0c91941a1ff9/schema)