---
title: "List Provider Directory Insights organizations (org picker)"
method: GET
path: "/api/v2/providers/{provider_id}/directoryinsights/organizations"
tags: ["Providers", "Directory Insights"]
---

# List Provider Directory Insights organizations (org picker)

`GET /api/v2/providers/{provider_id}/directoryinsights/organizations`

## Request

- Base URL: `https://console.jumpcloud.com`
- URL: `https://console.jumpcloud.com/api/v2/providers/{provider_id}/directoryinsights/organizations`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/jumpcloud/apis/jumpcloud-console-api/docs/api/v2/providers/:provider_id/directoryinsights/organizations/get.ts> (a function with typed inputs; its response is checked against the schema)

Lists organizations for the Provider Directory Insights org filter picker.

Returns accessible live child organizations under the path provider. Deleted
organization tombstones from ``organizations_deleted`` are included only when the
caller has OU provider primary-organization access (Enterprise DI deleted-org gate).
MSP deleted tombstones are not included.

Wrong-provider tombstones are never returned. Legacy tombstones missing ``provider``
are excluded by the provider-scoped query. Tombstones (or live orgs) missing a display
name return ``name: null``; Portal should fall back to ``id``.

Pagination and search:

- ``skip`` / ``limit`` (default limit 10, max 100) apply after merge, optional search,
  and case-insensitive name sort.
- ``search`` is an optional case-insensitive substring match on display name. Rows with
  a null name are omitted from search matches.

## Query parameters

- `limit` integer
- `skip` integer
- `search` string

## Response `200`

Accessible live orgs (+ authorized deleted tombstones).

- ProviderDirectoryInsightsOrganizationsResponse: Paginated list of Provider DI picker organizations (live + authorized deleted).
  - `totalCount` integer, required: Total matching rows before skip/limit pagination.
  - `results` ProviderDirectoryInsightsOrganization[], required
    - `id` string, required: Organization id (live org ``_id`` or tombstone ``_id``).
    - `name` string, nullable: Display name (live ``settings.name`` / tombstone ``name``). Null when unknown.
    - `status` 'active' | 'deleted', required
    - `deleted` string: Deletion timestamp (ISO string) when status is deleted.
    - `deleteType` string: Tombstone delete_type (e.g. internal, auto) when status is deleted.
    - `initiatedBy` string: Who initiated the delete when status is deleted.

## Other responses

- `400`: Bad Request
- `401`: Unauthenticated
- `403`: Unauthorized
- `404`: Not Found
- `500`: Internal Server Error

---

[API](https://skmtc.dev/jumpcloud/apis/jumpcloud-console-api.md) - [All operations](https://skmtc.dev/jumpcloud/apis/jumpcloud-console-api/llms.txt) - [OpenAPI document](https://skmtc.dev/jumpcloud/apis/jumpcloud-console-api/revisions/f396d9271b46?raw)