# Get Available Function Spaces

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

Returns the availability of function spaces in a specific venue based on some filtering criteria. This API is different to [Get Function Space Availability](/venues/venuedata/get-function-space-availability.md) in that besides allowing extra filtering, it returns the availability of function spaces for a maximum date-time range of 24 hours only. Availability timeslots are not returned.

#### Request Body

| Name          | Type      | Description                                                                                                                                 |
| ------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| venueId       | integer   | The id of the venue                                                                                                                         |
| startDatetime | timestamp | The start date and time of the activity. Format is Y-m-d H:i:s                                                                              |
| endDatetime   | timestamp | The end date and time of the activity. Format is Y-m-d H:i:s. The date and time range that of availability that can be fetched is 24 hours. |
| eventType     | integer   | The event type id applied to the function space                                                                                             |
| pax           | integer   | The number of attendees that the function space will be used for                                                                            |
| layoutType    | integer   | The layout type of the function space                                                                                                       |
| spaceIds      | array     | Optionally the list of space ids to which availability will be limited.                                                                     |

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

```
{
    "meta": {
        "totalResults": 2,
        "start": 0,
        "perPage": 100,
        "count": 2
    },
    "results": [
        {
            "id": 5991,
            "name": "Main Hall",
            "isAvailable": true,
            "reason": null,
            "conflict": null
        },
        {
            "id": 6048,
            "name": "Music hall",
            "isAvailable": false,
            "reason": 3,
            "conflict": {
                "venueId": 1,
                "bookingId": 30167,
                "sessionId": 25728,
                "spaceId": 6048,
                "startDate": "2025-07-20 09:00:00",
                "endDate": "2025-07-20 10:00:00",
                "pax": 10
            }
        }
    ]
}
```

{% endtab %}
{% endtabs %}

### Example Request

`Get Available function spaces`

```javascript
{
    "venueId":1,
    "startDatetime": "2025-11-26 09:00:00",
    "endDatetime": "2025-11-26 10:00:00",
    "eventType": 1,
    "pax": 10,
    "layoutType": 1,
    "spaceIds": [1]
}
```

### Returns

| Property    | Data Type | Description                                                                                  |
| ----------- | --------- | -------------------------------------------------------------------------------------------- |
| id          | integer   | The id of space to which the time slots belong.                                              |
| name        | string    | The name of space                                                                            |
| isAvailable | boolean   | Whether the space is available                                                               |
| reason      | integer   | The [reason](#conflict-reason) why the space is unavailable                                  |
| conflict    | object    | The [conflict](#conflict) object if there is a conflict with an existing booking reservation |

### Conflict Reason

| Value | Description                                                                                    |
| ----- | ---------------------------------------------------------------------------------------------- |
| 1     | The reservation is unavailable because the space has been blocked                              |
| 2     | The reservation is unavailable because the max pax on space has been crossed                   |
| 3     | The reservation is unavailable because there is a conflict with an exiting booking reservation |

### Conflict

| Property  | Data Type | Description                                                      |
| --------- | --------- | ---------------------------------------------------------------- |
| venueId   | integer   | The id of venue                                                  |
| bookingId | integer   | The id of booking                                                |
| sessionId | integer   | The id of session                                                |
| spaceId   | integer   | The id of space                                                  |
| startDate | string    | The start date of the conflict                                   |
| endDate   | string    | The end date of the conflict                                     |
| pax       | integer   | The number of attendees that the function space will be used for |


---

# 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-available-function-spaces.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.