---
title: "Get a List of Invitations for a Schema App"
method: GET
path: "/invites/schemaApp"
tags: ["SchemaApps"]
---

# Get a List of Invitations for a Schema App

`GET /invites/schemaApp`

## Request

- Base URL: `https://api.smartthings.com/v1`
- URL: `https://api.smartthings.com/v1/invites/schemaApp`
- Auth: one of:
  - OAuth 2
    - Implicit: `https://auth-global.api.smartthings.com`
    - Scopes: `mobile`
  - OAuth 2
    - Implicit: `https://auth-global.api.smartthings.com`
    - Scopes: `r:invitations`
- TypeScript: <https://skmtc.dev/smartthings/apis/smartthings-api/docs/invites/schemaApp/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve a list of invitations for a given Schema app ID.

## Query parameters

- `schemaAppId` string, required
- `limit` integer
- `page` string

## Response `200`

Success

- SchemaInvitePage: A page of schema invitations
  - `items` SchemaAppInvite[]
    - `id` string: The unique Id of the invitation
    - `schemaAppId` string: The unique Id of the schema app
    - `description` string: Optional description attached to the invitation
    - `expiration` number: Optional expiration in seconds from epoc
    - `acceptUrl` string: The URL that can be used to accept the invitation
    - `declineUrl` string: The URL that can be used to accept the invitation
    - `shortCode` string: The short code referencing the invitation
  - `links` Links
    - `next` Link
      - `href` string: An absolute URL linking to a resource.
    - `previous` Link
      - `href` string: An absolute URL linking to a resource.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `429`: Too many requests
- `default`: Unexpected error

## Changes

- **2026-11-07** `2788a4236800`: 2 info
  - the security scope `mobile` was added to the endpoint's security scheme `Bearer`
  - the security scope `r:invitations` was removed from the endpoint's security scheme `Bearer`
- **2026-07-27** `145c21700100`: 2 info
  - the security scope `mobile` was added to the endpoint's security scheme `Bearer`
  - the security scope `r:invitations` was removed from the endpoint's security scheme `Bearer`
- **2026-01-22** `6acc46f51053`: 2 info
  - the security scope `mobile` was added to the endpoint's security scheme `Bearer`
  - the security scope `r:invitations` was removed from the endpoint's security scheme `Bearer`
- **2025-05-16** `b04d2dce35dd`: 2 info
  - the security scope `mobile` was added to the endpoint's security scheme `Bearer`
  - the security scope `r:invitations` was removed from the endpoint's security scheme `Bearer`
- **2025-02-11** `32f2af0e7ed1`: 2 info
  - the security scope `mobile` was added to the endpoint's security scheme `Bearer`
  - the security scope `r:invitations` was removed from the endpoint's security scheme `Bearer`

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