# Samsung SmartThings

**Canonical:** https://apis.io/providers/smartthings/  
**Website:** https://www.smartthings.com  
**APIs profiled:** 14

Samsung SmartThings is a smart-home IoT platform for connecting, controlling, and automating devices across a home. The SmartThings API is a RESTful interface (base https://api.smartthings.com/v1) that lets integrations control devices, read device status, manage locations, rooms, and modes, build automations with Rules and Scenes, define and inspect capabilities, and build SmartApps that subscribe to events and run schedules. Authentication is via a Personal Access Token (PAT) for testing or OAuth 2.0 for production integrations. SmartThings publishes a real OpenAPI/Swagger definition at swagger.api.smartthings.com/public/st-api.yml. Event delivery is push-based over HTTP webhooks (SmartApp lifecycle callbacks and the Enterprise Eventing API sinks/subscriptions), not a public WebSocket.

## Kin Score — 36.1 / 100 (thin)

Scored 2026-08-21 under rubric 0.12.0. Trend: flat (+0.0 from 36.1).

| Facet | Score |
|---|---|
| Discoverability | 74.1 |
| Contract Quality | 56.9 |
| Governance | 0.0 |
| Contract Governance | 0.0 |
| Operational Transparency | 34.2 |
| Developer Ergonomics | 21.4 |
| Commercial Clarity | 28.9 |
| Access Clarity | 28.9 |

## Agent readiness — 29.1 (agent-aware)

| Dimension | Value |
|---|---|
| Spec Presence | yes |
| Agentic Access | derived |
| Reversibility Documented | no |
| MCP Server | no |
| Auth Clarity | yes |
| Idempotency | no |
| Error Semantics | no |
| OpenAPI Examples | no |
| Rate Limit Signal | documented |
| Event Surface Described | no |
| Agent Skills | no |
| Well Known Catalog | no |
| Consent Identity | no |
| Agent Card | no |
| Dry Run Mode | no |

## Access

Freemium · Self-serve signup — onboarding: self-serve, pricing: freemium, trial: no (confidence: high).

## APIs (14)

- **Samsung SmartThings Apps API** — SmartApp registrations (Lambda or webhook endpoints).
- **Samsung SmartThings Capabilities API** — Standard and custom capability definitions.
- **Samsung SmartThings Device Commands & Status API** — Execute commands, create events, and read device/component/capability status.
- **Samsung SmartThings Devices API** — Access, control, install, update, and delete devices.
- **Samsung SmartThings History API** — Event history for devices and locations.
- **Samsung SmartThings Installed Apps API** — Per-user installations of a SmartApp.
- **Samsung SmartThings Locations API** — Locations (homes) and their Modes.
- **Samsung SmartThings Presentations API** — Device presentation and configuration metadata.
- **Samsung SmartThings Rooms API** — Groupings of devices within a Location.
- **Samsung SmartThings Rules API** — Condition/action Automations over connected devices.
- **Samsung SmartThings Scenes API** — Saved sets of device states that can be executed on demand.
- **Samsung SmartThings Schedules API** — Future/cron executions for Installed Apps.
- **Samsung SmartThings Subscriptions API** — Event subscriptions for Installed Apps.
- **Samsung SmartThings Virtual Devices API** — Software devices for testing automations and integrations.

## Agentic access (1)

- **Smartthings Agentic Access** — 65 operations · 35 acting

## Security (3)

- **Smartthings Authentication** — http/oauth2 · 2 schemes
- **Smartthings Domain Security** — TLSv1.3 · HSTS · DMARC
- **Smartthings Vulnerability Disclosure** — Bugcrowd

## Plans (1)

- **Smartthings Plans Pricing**

## Tags

Smart Home, IoT, Home Automation, Devices, Samsung

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/providers/smartthings/). Scores are computed from the provider's own public artifacts under a published rubric.