Samsung SmartThings · Rate Limits

Smartthings Rate Limits

SmartThings publishes per-endpoint rate limits and platform "guardrails" (hard resource caps). Limits are applied per authenticated principal / per installed app and, for device operations, per device. Every response carries X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset headers. Exceeding a rate limit returns HTTP 429 (Too Many Requests); exceeding a guardrail (a hard cap such as max subscriptions per app) returns HTTP 422 (Unprocessable Entity). Values below are drawn from the public rate-limits documentation and are approximate; confirm current numbers before relying on them.

Smartthings Rate Limits is the machine-readable rate-limit profile for Samsung SmartThings on the APIs.io network, conforming to the API Commons Rate Limits specification.

It captures 17 rate-limit definitions, measuring requests, devices, subscriptions, schedules, and rules.

The profile also includes 3 backoff/retry policies defined and response codes documented for throttled and guardrail.

Tagged areas include Smart Home, IoT, Home Automation, Rate Limiting, and Quotas.

17 Limits Throttle: 429
Smart HomeIoTHome AutomationRate LimitingQuotasGuardrails

Limits

Devices - Get State / Send Commands / Create Events device
requests
12 per minute per device
Max 10 commands per command request; max 50 state events per events request.
Devices - Cloud-Connected per Installed App installedApp
devices
30 (guardrail)
Maximum cloud-connected devices an installed app may create.
Locations - Get / List account
requests
100 per minute
Locations - Create / Delete account
requests
50 per hour
Locations - Update account
requests
20 per hour
Subscriptions - Create installedApp
requests
40 every 15 minutes
Subscriptions - Other Operations installedApp
requests
15 every 15 minutes
Subscriptions per Installed App installedApp
subscriptions
40 (guardrail)
Maximum event size is approximately 10 KiB.
Schedules - Create (POST) installedApp
requests
12 per minute
Schedules - All Operations installedApp
requests
20 every 6 minutes
Schedules per Installed App installedApp
schedules
6 (guardrail)
Apps / Installed Apps account
requests
60 per minute
Max ~35 active apps per type per user; ~100 total per type (guardrails).
Lifecycle / Execute Events installedApp
requests
20 per minute
Applies to EVENT, UPDATE, INSTALL, UNINSTALL, CONFIGURATION, OAUTH_CALLBACK, EXECUTE, and PING.
Rules - Installed per User / per Installed App account
rules
100 per user, 50 per installed app (guardrails)
Capabilities / Device Profiles - Get by Id account
requests
15 per minute
Device Profiles - General account
requests
120 per minute
Modes location
requests
100-200 per minute depending on operation

Policies

Rate Limit Response
Requests exceeding a rate limit receive HTTP 429 (Too Many Requests).
Guardrail Response
Requests that would exceed a hard resource cap (guardrail) receive HTTP 422 (Unprocessable Entity).
Backoff Strategy
Clients should read the X-RateLimit-Reset header and implement exponential backoff with jitter on 429 responses.

Sources