Get Home List

Last Updated on : 2023-06-20 12:39:04download

Get the home list of the users who have been bound with the Tuya Voice Service accounts.

API address

GET: /v1.0/iot-01/voice/home/list

Return parameter

Parameter name	Type	Description
result	List	The returned result.
success	Boolean	Indicates whether the request succeeded. Valid values: `true`: succeeded. `false`: failed.
t	Long	The returned 13-bit timestamp.
code	Integer	The error code. It is empty on success.
msg	String	The error message that is returned if the request fails. It is empty on success.

Description of result

Parameter name	Type	Description
home_id	String	The ID of a home.
name	String	The name of a home.
lon	Double	The longitude of a home.
lat	Double	The latitude of a home.
geo_name	String	The geographic location of a home.

Request example

GET: /v1.0/iot-01/voice/home/list

Return example

{
    "result": [
        {
            "lon": 0,
            "name": "My Home",
            "home_id": "31426304",
            "lat": 0,
            "geo_name": ""
        },
        {
            "name": "Guest Home",
            "home_id": "32244069",
            "geo_name": ""
        }
    ],
    "t": 1627970779598,
    "success": true
}

Error code

For more information, see error code.