---
title: "Check the Acceptance Status of a Schema App Invitation"
method: GET
path: "/invites/schemaApp/checkAcceptance"
tags: ["SchemaApps"]
---

# Check the Acceptance Status of a Schema App Invitation

`GET /invites/schemaApp/checkAcceptance`

## Request

- Base URL: `https://api.smartthings.com/v1`
- URL: `https://api.smartthings.com/v1/invites/schemaApp/checkAcceptance`
- 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/checkAcceptance/get.ts> (a function with typed inputs; its response is checked against the schema)

## Query parameters

- `invitationId` string, required

## Response `200`

Success

- CheckSchemaAppInviteAcceptanceResponse: Acceptance status of a schema invitation
  - `schemaAppId` string: The unique Id of the schema app
  - `isAccepted` boolean: A boolean to represent if the invitation has been accepted or not
  - `description` string: Optional description attached to the invitation
  - `expiration` number: Optional expiration in seconds from epoc
  - `shortCode` string: The short code referencing the invitation

## 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/checkAcceptance/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)