# 전체 숙소 목록 요청하기

## Get room listings

<mark style="color:blue;">`GET`</mark> `https://backends.xyz/api/home/listings/`

queryset filter 추가. param에 필터=값 요청하여 검색 구분 가능. \_\_lte, \_\_gte, \_\_contains로 검색 정교화 필터 추가.

#### Path Parameters

| Name             | Type    | Description                  |
| ---------------- | ------- | ---------------------------- |
| city             | string  | .\_\_contains                |
| room\_name       | string  | .\_\_contains                |
| person\_capacity | integer | .\_\_lte, \_\_gte, \_\_exact |
| beds             | integer | .\_\_lte, \_\_gte, \_\_exact |
| bedrooms         | integer | .\_\_lte, \_\_gte, \_\_exact |
| bathrooms        | integer | .\_\_lte, \_\_gte, \_\_exact |
| id               | integer | .\_\_exact                   |

{% tabs %}
{% tab title="200    요청에 성공하면 아래와 같은 정보가 돌아옵니다." %}

```javascript
[
    {
        "pk": 1,
        "bathrooms": 2,
        "bedrooms": 1,
        "beds": 1,
        "person_capacity": 3,
        "room_name": "test room1",
        "room_type": "private",
        "room_and_property_type": "private room",
        "public_address": "우리집",
        "city": "서울특별시",
        "price": 50000,
        "lat": 1.1,
        "lng": 2.1,
        "created_at": "2018-11-26T00:31:12.770201+09:00",
        "amenities": [
            "wifi",
            "shower",
            "parking"
        ],
        "room_info": {
            "room_info_1": "Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.",
            "room_info_2": "Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.",
            "room_info_3": "Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.",
            "room_info_4": "Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.",
            "room_info_5": "Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.",
            "room_photo_1": "https://fc-team-project.s3.amazonaws.com/media/picture/host/listing/avatar.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAIXFXEGR3MLO4K2BQ%2F20181125%2Fap-northeast-2%2Fs3%2Faws4_request&X-Amz-Date=20181125T163050Z&X-Amz-Expires=3600&X-Amz-SignedHeaders=host&X-Amz-Signature=351f787bf58ed40f9e57ed9a52ff625d6450967ecf26effe231127fc14a8c6da",
            "room_photo_2": "https://fc-team-project.s3.amazonaws.com/media/picture/host/listing/avatar.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAIXFXEGR3MLO4K2BQ%2F20181125%2Fap-northeast-2%2Fs3%2Faws4_request&X-Amz-Date=20181125T163050Z&X-Amz-Expires=3600&X-Amz-SignedHeaders=host&X-Amz-Signature=351f787bf58ed40f9e57ed9a52ff625d6450967ecf26effe231127fc14a8c6da",
            "room_photo_3": "https://fc-team-project.s3.amazonaws.com/media/picture/host/listing/avatar.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAIXFXEGR3MLO4K2BQ%2F20181125%2Fap-northeast-2%2Fs3%2Faws4_request&X-Amz-Date=20181125T163050Z&X-Amz-Expires=3600&X-Amz-SignedHeaders=host&X-Amz-Signature=351f787bf58ed40f9e57ed9a52ff625d6450967ecf26effe231127fc14a8c6da",
            "room_photo_4": "https://fc-team-project.s3.amazonaws.com/media/picture/host/listing/avatar.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAIXFXEGR3MLO4K2BQ%2F20181125%2Fap-northeast-2%2Fs3%2Faws4_request&X-Amz-Date=20181125T163050Z&X-Amz-Expires=3600&X-Amz-SignedHeaders=host&X-Amz-Signature=351f787bf58ed40f9e57ed9a52ff625d6450967ecf26effe231127fc14a8c6da",
            "room_photo_5": "https://fc-team-project.s3.amazonaws.com/media/picture/host/listing/avatar.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAIXFXEGR3MLO4K2BQ%2F20181125%2Fap-northeast-2%2Fs3%2Faws4_request&X-Amz-Date=20181125T163050Z&X-Amz-Expires=3600&X-Amz-SignedHeaders=host&X-Amz-Signature=351f787bf58ed40f9e57ed9a52ff625d6450967ecf26effe231127fc14a8c6da"
        },
        "host_images": {
            "host_thumbnail_url": "https://fc-team-project.s3.amazonaws.com/media/pictures/host/IMG_3067.jpeg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAIXFXEGR3MLO4K2BQ%2F20181125%2Fap-northeast-2%2Fs3%2Faws4_request&X-Amz-Date=20181125T163050Z&X-Amz-Expires=3600&X-Amz-SignedHeaders=host&X-Amz-Signature=dc619ee569516a642322253d38446b6c3b71e21d082ef985721424c7e063dd36",
            "host_thumbnail_url_small": null
        }
    },
    {
        "pk": 2,
        "bathrooms": 2,
        "bedrooms": 4,
        "beds": 1,
        "person_capacity": 3,
        "room_name": "test room 2",
        "room_type": "집 전체",
        "room_and_property_type": "entire place",
        "public_address": "Building",
        "city": "서울특별시",
        "price": 5000,
        "lat": 1.1,
        "lng": 1.1,
        "created_at": "2018-11-26T00:33:15.066034+09:00",
        "amenities": [
            "wifi",
            "shower",
            "parking",
            "pool"
        ],
        "room_info": {
            "room_info_1": "Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.",
            "room_info_2": "Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.",
            "room_info_3": "Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.",
            "room_info_4": "Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.",
            "room_info_5": "Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.",
            "room_photo_1": "https://fc-team-project.s3.amazonaws.com/media/picture/host/listing/avatar.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAIXFXEGR3MLO4K2BQ%2F20181125%2Fap-northeast-2%2Fs3%2Faws4_request&X-Amz-Date=20181125T163050Z&X-Amz-Expires=3600&X-Amz-SignedHeaders=host&X-Amz-Signature=351f787bf58ed40f9e57ed9a52ff625d6450967ecf26effe231127fc14a8c6da",
            "room_photo_2": "https://fc-team-project.s3.amazonaws.com/media/picture/host/listing/avatar.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAIXFXEGR3MLO4K2BQ%2F20181125%2Fap-northeast-2%2Fs3%2Faws4_request&X-Amz-Date=20181125T163050Z&X-Amz-Expires=3600&X-Amz-SignedHeaders=host&X-Amz-Signature=351f787bf58ed40f9e57ed9a52ff625d6450967ecf26effe231127fc14a8c6da",
            "room_photo_3": "https://fc-team-project.s3.amazonaws.com/media/picture/host/listing/avatar.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAIXFXEGR3MLO4K2BQ%2F20181125%2Fap-northeast-2%2Fs3%2Faws4_request&X-Amz-Date=20181125T163050Z&X-Amz-Expires=3600&X-Amz-SignedHeaders=host&X-Amz-Signature=351f787bf58ed40f9e57ed9a52ff625d6450967ecf26effe231127fc14a8c6da",
            "room_photo_4": "https://fc-team-project.s3.amazonaws.com/media/picture/host/listing/avatar.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAIXFXEGR3MLO4K2BQ%2F20181125%2Fap-northeast-2%2Fs3%2Faws4_request&X-Amz-Date=20181125T163050Z&X-Amz-Expires=3600&X-Amz-SignedHeaders=host&X-Amz-Signature=351f787bf58ed40f9e57ed9a52ff625d6450967ecf26effe231127fc14a8c6da",
            "room_photo_5": "https://fc-team-project.s3.amazonaws.com/media/picture/host/listing/avatar.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAIXFXEGR3MLO4K2BQ%2F20181125%2Fap-northeast-2%2Fs3%2Faws4_request&X-Amz-Date=20181125T163050Z&X-Amz-Expires=3600&X-Amz-SignedHeaders=host&X-Amz-Signature=351f787bf58ed40f9e57ed9a52ff625d6450967ecf26effe231127fc14a8c6da"
        },
        "host_images": {
            "host_thumbnail_url": "https://fc-team-project.s3.amazonaws.com/media/pictures/host/IMG_3067.jpeg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAIXFXEGR3MLO4K2BQ%2F20181125%2Fap-northeast-2%2Fs3%2Faws4_request&X-Amz-Date=20181125T163050Z&X-Amz-Expires=3600&X-Amz-SignedHeaders=host&X-Amz-Signature=dc619ee569516a642322253d38446b6c3b71e21d082ef985721424c7e063dd36",
            "host_thumbnail_url_small": null
        }
    },
    {
        "pk": 3,
        "bathrooms": 4,
        "bedrooms": 3,
        "beds": 2,
        "person_capacity": 3,
        "room_name": "test room 3",
        "room_type": "entire place",
        "room_and_property_type": "entire place",
        "public_address": "우리집",
        "city": "서울특별시",
        "price": 60000,
        "lat": 1.1,
        "lng": 2.2,
        "created_at": "2018-11-26T00:37:46.447133+09:00",
        "amenities": [
            "wifi",
            "shower",
            "parking",
            "pool"
        ],
        "room_info": {
            "room_info_1": "Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.",
            "room_info_2": "Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.",
            "room_info_3": "Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.",
            "room_info_4": "Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.",
            "room_info_5": "Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.",
            "room_photo_1": "https://fc-team-project.s3.amazonaws.com/media/picture/host/listing/avatar.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAIXFXEGR3MLO4K2BQ%2F20181125%2Fap-northeast-2%2Fs3%2Faws4_request&X-Amz-Date=20181125T163050Z&X-Amz-Expires=3600&X-Amz-SignedHeaders=host&X-Amz-Signature=351f787bf58ed40f9e57ed9a52ff625d6450967ecf26effe231127fc14a8c6da",
            "room_photo_2": "https://fc-team-project.s3.amazonaws.com/media/picture/host/listing/avatar.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAIXFXEGR3MLO4K2BQ%2F20181125%2Fap-northeast-2%2Fs3%2Faws4_request&X-Amz-Date=20181125T163050Z&X-Amz-Expires=3600&X-Amz-SignedHeaders=host&X-Amz-Signature=351f787bf58ed40f9e57ed9a52ff625d6450967ecf26effe231127fc14a8c6da",
            "room_photo_3": "https://fc-team-project.s3.amazonaws.com/media/picture/host/listing/avatar.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAIXFXEGR3MLO4K2BQ%2F20181125%2Fap-northeast-2%2Fs3%2Faws4_request&X-Amz-Date=20181125T163050Z&X-Amz-Expires=3600&X-Amz-SignedHeaders=host&X-Amz-Signature=351f787bf58ed40f9e57ed9a52ff625d6450967ecf26effe231127fc14a8c6da",
            "room_photo_4": "https://fc-team-project.s3.amazonaws.com/media/picture/host/listing/avatar.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAIXFXEGR3MLO4K2BQ%2F20181125%2Fap-northeast-2%2Fs3%2Faws4_request&X-Amz-Date=20181125T163050Z&X-Amz-Expires=3600&X-Amz-SignedHeaders=host&X-Amz-Signature=351f787bf58ed40f9e57ed9a52ff625d6450967ecf26effe231127fc14a8c6da",
            "room_photo_5": "https://fc-team-project.s3.amazonaws.com/media/picture/host/listing/avatar.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAIXFXEGR3MLO4K2BQ%2F20181125%2Fap-northeast-2%2Fs3%2Faws4_request&X-Amz-Date=20181125T163050Z&X-Amz-Expires=3600&X-Amz-SignedHeaders=host&X-Amz-Signature=351f787bf58ed40f9e57ed9a52ff625d6450967ecf26effe231127fc14a8c6da"
        },
        "host_images": {
            "host_thumbnail_url": "https://fc-team-project.s3.amazonaws.com/media/pictures/host/avatar.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAIXFXEGR3MLO4K2BQ%2F20181125%2Fap-northeast-2%2Fs3%2Faws4_request&X-Amz-Date=20181125T163050Z&X-Amz-Expires=3600&X-Amz-SignedHeaders=host&X-Amz-Signature=c13653c484563bed9ac3d06bcc81272fb79bfc639da097e6f8fc76c6d2ba5d29",
            "host_thumbnail_url_small": null
        }
    }
]
```

{% endtab %}
{% endtabs %}