---
title: "Get Schema App Info"
method: GET
path: "/schema/apps/{endpointAppId}"
tags: ["SchemaApps"]
---

# Get Schema App Info

`GET /schema/apps/{endpointAppId}`

## Request

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

Get SmartThings Schema App-related information.

## Path parameters

- `endpointAppId` string, required

## Headers

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

## Response `200`

Success

- 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
- `404`: Not Found
- `500`: InternalServiceError

## Changes

- **2025-05-16** `b04d2dce35dd`: 1 info
  - added the new optional `header` request parameter `X-ST-Organization`
- **2022-12-19** `adcacfc2749d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/smartthings/apis/smartthings-api/changes/schema/apps/:endpointAppId/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)