# Get Function Space Availability

<mark style="color:green;">`POST`</mark> `[PlatformAddress]/api/1.0/venue?action=getFunctionSpaceAvailability`

Returns the availability of function spaces in a specific venue.

#### Request Body

| Name      | Type    | Description                                                                                                                                   |
| --------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| venueId   | integer | The id of the venue                                                                                                                           |
| startDate | date    | The date from which the availability data will be fetched. Format YYY-MM-DD                                                                   |
| endDate   | date    | The date to which the availability data will be fetched. Format YYY-MM-DD. The maximum number of days of available that can be fetched is 14. |
| spaceIds  | array   | Optionally the list of space ids to which availability will be limited.                                                                       |

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

```
{
    "availability": [
        {
            "spaceId": 1,
            "timeSlots": [
                {
                    "date": "2020-11-26",
                    "startTime": "00:00:00",
                    "endTime": "23:59:59"
                },
                {
                    "date": "2020-11-27",
                    "startTime": "00:00:00",
                    "endTime": "09:00:00"
                },
                {
                    "date": "2020-11-27",
                    "startTime": "17:00:00",
                    "endTime": "23:59:59"
                },
                {
                    "date": "2020-11-28",
                    "startTime": "00:00:00",
                    "endTime": "23:59:59"
                },
                {
                    "date": "2020-11-29",
                    "startTime": "00:00:00",
                    "endTime": "23:59:59"
                },
                {
                    "date": "2020-11-30",
                    "startTime": "00:00:00",
                    "endTime": "23:59:59"
                }
            ]
        },
        {
            "spaceId": 2,
            "timeSlots": [
                {
                    "date": "2020-11-26",
                    "startTime": "00:00:00",
                    "endTime": "23:59:59"
                },
                {
                    "date": "2020-11-27",
                    "startTime": "00:00:00",
                    "endTime": "23:59:59"
                },
                {
                    "date": "2020-11-28",
                    "startTime": "00:00:00",
                    "endTime": "23:59:59"
                },
                {
                    "date": "2020-11-29",
                    "startTime": "00:00:00",
                    "endTime": "23:59:59"
                },
                {
                    "date": "2020-11-30",
                    "startTime": "00:00:00",
                    "endTime": "23:59:59"
                }
            ]
        }
    ]
}
```

{% endtab %}
{% endtabs %}

### Example Request

`Get Venues Function Space List`

```javascript
{
    "venueId":1,
    "startDate": "2020-11-26",
    "endDate": "2020-11-30",
    "spaceIds": [1, 2]
}
```

### Returns

`A collection object with the following properties in the results`

| Property     | Data Type | Description                                                                   |
| ------------ | --------- | ----------------------------------------------------------------------------- |
| availability | array     | Array of spaces with availability data. See "Space Availability" for details. |

### Space Availability

`A collection object with the following properties in the results`

| Property  | Data Type | Description                                                  |
| --------- | --------- | ------------------------------------------------------------ |
| spaceId   | integer   | The id of space to which the time slots belong.              |
| timeSlots | array     | The array of time slots. See "Space Time Slots" for details. |

### Space Time Slots

`A collection object with the following properties in the results`

| Property  | Data Type | Description                                                |
| --------- | --------- | ---------------------------------------------------------- |
| date      | date      | The date to which the time slot applies. Format YYYY-MM-DD |
| startTime | string    | The start time of the available time slot. Format H:i:s    |
| endTime   | string    | The end time of the available time slot. Format H:i:s      |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developer.ivvy.com/venues/venuedata/get-function-space-availability.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.