> For the complete documentation index, see [llms.txt](https://cupnoodles.gitbook.io/open-api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cupnoodles.gitbook.io/open-api/ch3/requsetformat.md).

# Request Format

```
{
    "inputs": [
        {
            "intent": "action.devices.QUERY", 
            "payload": {
                "devices": [
                    {
                        "customData": {
                            "region": "CN",
                            "model": "yeelink-mono1"
                        }, 
                        "id": "M1GAxtaW9A0LXNwZWMtdjIVgoAFGA15ZWVsaW5rLW1vbm8xFRQYCDQ1MTAyMzgwFWYA"
                    }, 
                    {
                        "customData": {
                            "region": "CN",
                            "model": "yeelink-color1"
                        }, 
                        "id": "M1GAxtaW9A0LXNwZWMtdjIVgoAFGA55ZWVsaW5rLWNvbG9AyMRUUGAg0NTk2NTYwNRVoAA"
                    }
                ]
            }
        }
    ], 
    "requestId": "14671248160676185539"
}
```

| **Params** | **Type** | **Value**            | **Remarks**                                               |
| ---------- | -------- | -------------------- | --------------------------------------------------------- |
| requestId  | String   | 4180463424101195867  | Random string as Id of each request for  ease of tracing. |
| intent     | String   | action.devices.QUERY | Required.                                                 |