List mapped properties

POST

/api/v1/mapped/properties

Returns the list of your properties and their mapping status
against Swoovo master hotels.

Status values:

mapped — full match found

review — partial match, awaiting manual confirmation

no_match — no matching master hotel found

This endpoint is synchronous (no job_id). Response is paginated
via the standard total field.

Request

Authorization

API Key

Add parameter in header

X-API-Key

Example:

X-API-Key: ********************

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Mapped properties fetched successfully

Bodyapplication/json

🟠400BadRequest

🟠401Unauthorized

Request Example

Shell

JavaScript

Java

Swift

curl --location '/api/v1/mapped/properties' \
--header 'X-API-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "ota_code": "swoovo_MYTR_6017"
}'

Response Example

200 - Example 1

{
    "status": true,
    "message": "Mapped properties fetched successfully",
    "data": {
        "total": 4463,
        "properties": [
            {
                "ota_property_id": "7270474283",
                "status": "mapped",
                "ota_hotel_name": "Vista by Booksy One",
                "swoovo_hotel_name": "Super Collection O Kureepuzha Kollam",
                "confidence_score": 100,
                "error": "Hotel 7653530460: no matching master hotels found",
                "updated_at": "2026-05-11T10:49:43Z"
            }
        ]
    }
}

Modified at 2026-11-12 09:12:10

Push pricing overrides (async)

Get room push job status