---
title: "Get Organization Microsoft Tenant IDs"
method: GET
path: "/v1/organizations/{organizationId}/microsoft-tenant-ids"
tags: ["BackendService"]
---

# Get Organization Microsoft Tenant IDs

`GET /v1/organizations/{organizationId}/microsoft-tenant-ids`

## Request

- The document declares no server URL.
- Auth: none declared

Get Organization Microsoft Tenant IDs.

## Path parameters

- `organizationId` string, required

## Response `200`

OK

- GetOrganizationMicrosoftTenantIDsResponse
  - `organizationMicrosoftTenantIds` OrganizationMicrosoftTenantIDs: OrganizationMicrosoftTenantIDs represents the Microsoft Tenant IDs ("TIDs") associated with an Organization.
    - `organizationId` string: The ID of the Organization.
    - `microsoftTenantIds` string[]: A list of Microsoft Tenant IDs associated with the organization. These values correspond to Microsoft OAuth `tid` claims: https://learn.microsoft.com/en-us/entra/identity-platform/id-token-claims-reference

## Other responses

- `400`: API Error
- `401`: API Error
- `403`: API Error
- `404`: API Error

## Changes

- **2025-03-11** `e3ac0347dfbe`: 1 breaking, 2 warning, 1 info
  - the `organizationMicrosoftTenantIds` response's property type changed from `object` to no type for status `200`
  - removed the optional property `organizationMicrosoftTenantIds/microsoftTenantIds` from the response with the `200` status
  - removed the optional property `organizationMicrosoftTenantIds/organizationId` from the response with the `200` status
  - added `#/components/schemas/OrganizationMicrosoftTenantIDs` to the `organizationMicrosoftTenantIds` response property `allOf` list for the response status `200`
- **2025-03-05** `aae16339e1e1`: 4 breaking, 8 warning
  - the `details/items/` response's property type changed from `object` to no type for status `400`
  - the `details/items/` response's property type changed from `object` to no type for status `401`
  - the `details/items/` response's property type changed from `object` to no type for status `403`
  - the `details/items/` response's property type changed from `object` to no type for status `404`
  - …8 more
- **2025-03-04** `b9fc18a0eac3`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/tesseral-labs/apis/backendservice-api/changes/v1/organizations/:organizationId/microsoft-tenant-ids/get.md)

---

[API](https://skmtc.dev/tesseral-labs/apis/backendservice-api.md) - [All operations](https://skmtc.dev/tesseral-labs/apis/backendservice-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tesseral-labs/apis/backendservice-api/revisions/fe83f78ae20a?raw)