---
title: "GET /schema/apps/organizations"
method: GET
path: "/schema/apps/organizations"
tags: ["SchemaApps"]
---

# GET /schema/apps/organizations

`GET /schema/apps/organizations`

## Request

- Base URL: `https://api.smartthings.com/v1`
- URL: `https://api.smartthings.com/v1/schema/apps/organizations`
- Auth: none declared. Required headers: `Authorization`
- TypeScript: <https://skmtc.dev/smartthings/apis/smartthings-api/docs/schema/apps/organizations/get.ts> (a function with typed inputs; its response is checked against the schema)

Get all SmartThings Schema Apps associated with the specified organizationId.
If a service token is used, then organizationId must be specified in the header. If a personal access token is used and an organizationId is not specified, then all endpointAppRecords with an organizationId(s) associated with the specified personal access token are listed.

## Headers

- `Authorization` string, Bearer token, required
- `X-ST-Organization` string, organizationId

## Response `200`

Success

- OrganizationIdApp
  - `organizationIds` string[]: Organization IDs
  - `endpointApps` EndpointApp[]
    - `appName` string: The name of the SmartThings Schema integration
    - `partnerName` string: The name of the brand or organization associated with this Schema integration
    - `oAuthAuthorizationUrl` string: OAuth authorization url provided by the associated OAuth application
    - `lambdaArn` string: Lambda ARN of the associated Cloud Connector in the US region
    - `lambdaArnEU` string: Lambda ARN for the EU region
    - `lambdaArnAP` string: Lambda ARN for the AP region
    - `lambdaArnCN` string: Lambda ARN for the CN region
    - `icon` string: The URL of the integration icon. This icon is displayed to end users.
    - `icon2x` string: The URL of the integration icon @ 2x dimensions
    - `icon3x` string: The URL of the integration icon @ 3x dimensions
    - `endpointAppId` string: The endpoint app ID
    - `oAuthClientId` string: The Client ID for the associated OAuth client
    - `oAuthClientSecret` string: The associated OAuth app Client Secret
    - `oAuthTokenUrl` string: The OAuth token refresh URL of the associated OAuth client
    - `organizationId` string: The organization ID of this Schema integration
    - `oAuthScope` string: The OAuth client scope.
    - `userId` string: The associated user ID
    - `hostingType` string: Possible values - "lambda" or "webhook"
    - `schemaType` string: Possible values - "alexa-schema", "st-schema", "google-schema"
    - `webhookUrl` string: Webhook URL where this Schema integration receives events.
    - `certificationStatus` string: Possible values - "", "cst", "wwst", "review"
    - `userEmail` string: The email associated with this Schema integration.
    - `viperAppLinks` ViperAppLinks
      - `android` string: app deep linking to partners in android
      - `ios` string: app deep linking to partners in ios
      - `isLinkingEnabled` boolean: whether deep app linking is enabled

## Other responses

- `400`: BadRequest
- `401`: Unauthorized
- `403`: Forbidden
- `500`: InternalServiceError

## Changes

- **2025-02-11** `32f2af0e7ed1`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/smartthings/apis/smartthings-api/changes/schema/apps/organizations/get.md)

---

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