# Get Widgets and Items

## **Explanation**

This API must be called before submitting any order to check the availability of widgets and items. Widgets can be optional or mandatory depending on the service.

***

<mark style="color:green;">**`GET`**</mark>**` ``https://api.aihomedesign.com/v1/catalog/items/filter`**

***

**Query Parameters:**

* `space_name` (string): Set your desired space name e.g. `space-bedroom`
* `service_name` (string): Set your desired service name e.g. `service-ai-creative-designer`

## Response

{% tabs %}
{% tab title="200: OK" %}

```json
{
    "data": [
        {
            "id": string,
            "title": string,
            "description": string,
            "is_optional": boolean,
            "items": [
                {
                    "id": string,
                    "title": string,
                    "prompt": string,
                    "icon_src": string,
                    "is_premium": boolean
                }
            ],
            "priority": numeric,
            "type": string
        }
    ]
}
```

{% endtab %}

{% tab title="400: Bad Request" %}

```json
{
    "error": string,
    "key": string
}
```

{% endtab %}
{% endtabs %}