API Reference

Base URL: https://api.y-home.cc/v1 · Auth: Bearer token (OAuth 2.0 client credentials).

List devices

GET /v1/sites/{site_id}/devices
Authorization: Bearer <access_token>

{
  "data": [
    {"id":"dev_8f2a","type":"light","brand":"philips","online":true},
    {"id":"dev_1c93","type":"lock","brand":"august","online":true}
  ],
  "next_cursor": null
}

Set device state

POST /v1/devices/{device_id}/state
{"brightness": 80, "color_temp": 3000}

200 OK  {"id":"dev_8f2a","state":{"brightness":80},"updated_at":"2026-01-14T09:22:11Z"}

Rate limits

PlanRequests / minBurst
Developer60120
Business6001200
EnterpriseCustomCustom

Webhooks, pagination and error codes are covered in the full developer portal. Contact support@y-home.cc for sandbox credentials.