A Multi-Unit Parent Listing
This endpoint creates a parent listing (compound, establishment, guest houses, or hotel) and returns a "providerGroupId" to be used with other Multi-Unit endpoints.
Create Parent Listing Endpoint:
This endpoint is used to create a parent listing in our system. A parent listing represents an entire compound, establishment, or hotel, and serves as the root entity for all associated units.
Only query parameters are required, along with an empty JSON object ({}) as the request body. No JSON body needs to be sent in this request.
Once the request is successful, the system generates a parent listing with this ID.
You can then use this providerGroupId with all other Multi-Unit endpoints (e.g., Descriptions, Photos, Facilities) to add details and enrich the parent listing.
Create Parent Listing
Endpoint
POST https://provider-api.holidu.com/v2/multi-unit
Request
Headers
| Key | Value | Description |
|---|---|---|
api-key | <your-api-key> | Authentication key (depends on environment) |
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
provider | string | Yes | Your provider identifier |
providerGroupId | string | Yes | A new parent listing is created, which will have this ID |
Body
{}
(empty JSON object)
Response
200 OK
Once the parent listing is created and all the info has been added to it, you can add child listings (apartments/units) to the group ⤵
Enrich the parent listing with Descriptions, Photos, and Facilities using the
providerGroupId.
- Create child apartments using the existing Apartment API.
- Link them to the parent listing via the
providerApartmentGroupId.- Push child-level information only (e.g., unit-specific details).
Updated about 12 hours ago
You can now enrich the parent listing by using the Multi-Unit Parent Listing endpoints for Descriptions, Photos, and Facilities.