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

# List Rooms

The "List Rooms" endpoint provides an overview of all rooms within the system. It's designed for users who need to retrieve a comprehensive list of rooms, including their details and associated housing units. This capability is crucial for managing inventory and understanding room availability

<mark style="color:green;">`GET`</mark> `/rooms`

**Headers**

| Name          | Value              |
| ------------- | ------------------ |
| Content-Type  | `application/json` |
| Authorization | `JWT <token>`      |

**Query Params**

| Name         | Type   | Description             |
| ------------ | ------ | ----------------------- |
| `housing_id` | string | Housing ID of the rooms |

**Response**

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

```json
{
    "count": 10,
    "next": null,
    "previous": null,
    "results": [
        {
            "id": "2c688b561dbc480b9b6e2abfaa4d112f",
            "number": "Space 1",
            "external_id": "",
            "external_name": "",
            "housing": "344d12335dd34756bbfe4cd691b26def"
        },
        {
            "id": "3091de650dff46a39a47cc5415b894e3",
            "number": "Space 2",
            "external_id": "",
            "external_name": "",
            "housing": "344d12335dd34756bbfe4cd691b26def"
        },
```

{% endtab %}
{% endtabs %}