1. Mapping API
Vervotech
  • Hotel Mapping
    • Getting Started
    • Access & Onboarding with Vervotech
    • Explore your providers
    • Integration and Go Live
    • Map Providers Content
    • Webhook
    • References
    • FAQ
    • Metadata Content
      • Get Master Hotel Facilities
      • Get Master Hotel Chains
      • Get Master Hotel Brands
      • Get Master Property Types
      • Get All Master Countries
      • Get All Vervotech IDs
    • Mappings
      • Get Mappings
      • Get New Mappings
      • Get Updated Mappings
      • Get Deleted Mappings
      • Get Mapping Statistics
      • Export Mappings File
      • Get Mapping Counts
      • Get Provider Hotel Mappings by Provider ID
      • Get Provider Hotel Mappings by Vervotech ID
    • Curated Content
      • Get Updated Curated Content
      • Get Curated Content by Provider Hotel IDs
      • Get Curated Content by Vervotech IDs
    • Provider Content
      • Get Unmapped Provider Hotels
      • Get Unmapped Provider Hotels V2
      • Create Unmapped Provider Hotels File
      • Get All Provider Names
      • Get Provider Content by Provider Hotel IDs
      • Get Provider Content by Vervotech IDs
    • Location Content
      • Get Location by ID
      • Get All Locations
    • Operational APIs
      • Review Mappings of Booked Hotels by File
      • Review Mappings of Booked Hotels
      • Start Mapping by SFTP Folder
      • Get Mapping History by Run ID
    • Dynamic Mapping APIs
      • Find Match
    • Dual Mapping APIs
      • Overview
      • Get Mappings by Provider Hotel ID
      • Get Mappings with Content by Provider Hotel ID
      • Get Dual Mapping API Statistics
  • Room Mapping
    • Getting Started
    • Choosing Your Integration Path
    • Preparing Your Request Data
    • Room Name and Description Guidelines
    • Integration Guidelines and Go Live
    • Room Mapping Customizations
    • Service Limits
    • Preparing Your Files
    • How Supplier Content Is Standardised
    • FAQ
    • References
    • Mapping API
      • Map Rooms
        POST
      • Get Master Room Amenities
        GET
      • Get Master Room Attributes
        GET
      • Get Provider Names
        GET
      • Get All Provider Names
        GET
    • Async Room Mapping API
      • Get Async Room Mapping Response
      • Map Large Rooms Async
    • Board Basis Mappings
      • Get All Master Board Basis
      • Map Board Basis
    • File Based Room Mapping (Offline)
      • Download Mapped File Or Sample File
      • Submit Rooms File
      • Get File Mapping Status
  • Schemas
    • Schemas
    • Response
      • GetMasterHotelBrandsResponse
      • GetMasterPropertyTypesResponse
      • GetMasterCountriesResponse
      • FacilityGroupFixtures
      • GetMasterHotelChainsResponse
    • GetMasterHotelBrandsResponse1
    • GetMasterPropertyTypesResponse2
    • GetMasterCountriesResponse3
    • FacilityGroupFixtures4
    • GetMasterHotelChainsResponse5
    • GetMasterHotelBrandsResponse2
    • GetMasterPropertyTypesResponse3
    • GetMasterCountriesResponse4
    • PropertyContent400Error
    • FacilityGroupFixtures5
    • PropertyContent404Error
    • GetMasterHotelChainsResponse6
    • HotelChain404Error
    • MasterCountry404Error
    • BucketFolderNotFound
    • ProviderNames404Error
    • PropertyType404Error
    • Error401
    • Error403
    • Error426
    • Error500
    • Error503
    • Facility404Error
    • TotalHotelsCount404Error
    • Location404Error
    • Location400Error
    • GetMasterHotelBrandsResponse3
    • GetMasterPropertyTypesResponse4
    • GetMasterCountriesResponse5
    • FacilityGroupFixtures6
    • GetMasterHotelChainsResponse7
    • Status
    • Message
    • StatusCode
    • ResumeKey
    • Tag
    • GetHotelsByLocationIdRes
    • GetHotelsByPolygonRes
    • Unica.Core.Contracts.Models.DownloadStatsStatus
    • Unica.Core.Contracts.Models.HotelsAPI.HotelContentField
    • PropertyTypes
    • schema1
    • schema3
    • Unica.Core.Contracts.Models.HotelsAPI.HotelMappingV3.ProviderMappingType
    • Unica.Core.Contracts.Models.ImageSize
    • Unica.DataContracts.Common.DistanceUnit
    • Unica.DataContracts.Common.FeeType
    • Unica.DataContracts.Common.ImageSize
    • Unica.Services.CoreService.Models.GetProviderMappingMappingRq
    • Countries
    • KeyValue
    • ProviderFacility
    • GenericResponse
    • ProviderHotelIdentifier
    • GetUnmappedHotelsResponse
    • GetMasterHotelChainsResponse
    • GetUnmappedHotelsV2Response
    • GetCuratedContentResponse
    • ErrorResponse
    • Bed
    • GetUpdatedCuratedContentResponse
    • ReviewMappingsofBookedHotelsResponse
    • GetProviderMappingResponse
    • GetProviderMappingByProviderResponse
    • GetMappingHistoryByRunIdResponse
    • CategoryRating
    • GetMasterHotelBrandsResponse
    • Unica.Core.Contracts.Models.HotelsAPI.HotelMappingV3.GetProviderContentByProviderIdsReq
    • GetMasterPropertyTypesResponse
    • GetMasterCountriesResponse
    • Error
    • LocationsRS
    • Unica.Core.Contracts.Models.HotelsAPI.HotelMappingV3.ProviderHotelMappings
    • Unica.Core.Contracts.Models.HotelsAPI.HotelMappingV3.ReviewBookedHotelsReq
    • Unica.Core.Contracts.Models.MasterTags.Tags
    • Unica.Core.Contracts.Models.ProviderHotelIdentifier
    • Unica.DataContracts.Common.CategoryRating
    • Unica.DataContracts.Common.CheckoutInfo
    • Unica.DataContracts.Common.Description
    • Unica.DataContracts.Common.GeoCode
    • Unica.DataContracts.Common.Link
    • Unica.DataContracts.Common.Policy
    • Unica.Core.Contracts.Location.MasterLocationRes
    • Unica.DataContracts.Common.ReviewDistribution
    • GetMappingsCountRes
    • Unica.Core.Contracts.Models.Airport
    • Unica.Core.Contracts.Models.ApiResponse
    • Unica.Core.Contracts.Models.Billing.AccountUsageBalance
    • Unica.Core.Contracts.Models.Billing.BilllingHistory
    • Unica.Core.Contracts.Models.ConnectedLocation
    • Unica.Core.Contracts.Models.Facility
    • AsyncRoomMappingResponse
    • GetMappingStatisticsResponse
    • Unica.Core.Contracts.Models.GetAllHotelBrandsRes
    • Unica.Core.Contracts.Models.GetAllHotelChainsRes
    • Unica.Core.Contracts.Models.GetAllMasterTagsResV3
    • Unica.Core.Contracts.Models.GetMappingHistoryReq
    • Facility
    • NearByLocation
    • TrainStations
    • StartMappingByFtpFolderResponse
    • PointOfInterests
    • ConnectedLocations
    • Unica.Core.Contracts.Models.HotelsAPI.HotelMappingV3.GetCuratedContentWithLocationRes
    • Neighbourhoods
    • Unica.Core.Contracts.Models.HotelsAPI.HotelMappingV3.GetMappingByProviderRes
    • Stadiums
    • Unica.Core.Contracts.Models.HotelsAPI.HotelMappingV3.GetMasterFacilityGroups
    • Unica.Core.Contracts.Models.HotelsAPI.HotelMappingV3.GetProviderContentRes
    • Unica.Core.Contracts.Models.HotelsAPI.HotelMappingV3.GetUnmappedProviderHotelsRes
    • Unica.Core.Contracts.Models.HotelsAPI.HotelMappingV3.MasterFacilityGroups
    • Unica.Core.Contracts.Models.KeyValue
    • Unica.Core.Contracts.Models.Link
    • Unica.Core.Contracts.Models.MappingStatsRes
    • Unica.Core.Contracts.Models.MasterChain.HotelBrand
    • Unica.Core.Contracts.Models.MasterChain.HotelChain
    • Unica.Core.Contracts.Models.Neighbourhood
    • Unica.Core.Contracts.Models.PoI
    • Unica.Core.Contracts.Models.ProviderHotelHistoryRes
    • Unica.Core.Contracts.Models.RoomArea
    • Unica.Core.Contracts.Models.Stadium
    • Unica.Core.Contracts.Models.TrainStation
    • Unica.DataContracts.Common.Facility
    • Unica.DataContracts.Common.Fee
    • Unica.DataContracts.Common.KeyValue
    • Unica.DataContracts.Common.RoomArea
    • Unica.DataContracts.Common.Statistics
    • Unica.Core.Contracts.Location.MasterLocationListRes
    • Unica.Core.Contracts.Models.Bed
    • LocationByPolygonRequest
    • ProviderHotelIdentifiers
    • Unica.Core.Contracts.Models.Billing.UsageBalanceDetails
    • RoomMappingWarning
    • HotelProviderIdentifier
    • Unica.Core.Contracts.Models.GetAllCountriesResV3
    • Unica.Core.Contracts.Models.GetAllPropertyTypesRes
    • GuestReview
    • GetProviderNamesResponse
    • Unica.Core.Contracts.Models.GetMappingsCountRes
    • GetAllVervotechIdsResponse
    • Unica.Core.Contracts.Models.GetProviderMappingStatsRS
    • Unica.Core.Contracts.Models.HotelsAPI.HotelMappingV3.CreateUnmappedProviderHotelsFileReq
    • Unica.Core.Contracts.Models.HotelsAPI.HotelMappingV3.GetCuratedContentByVervotechIdsReq
    • Unica.Core.Contracts.Models.HotelsAPI.HotelMappingV3.GetMappingsRes
    • Unica.Core.Contracts.Models.HotelsAPI.HotelMappingV3.GetUnmappedProviderHotelsReq
    • Unica.Core.Contracts.Models.HotelsAPI.HotelMappingV3.GetUnmappedProviderHotelsV2Req
    • Unica.Core.Contracts.Models.HotelsAPI.HotelMappingV3.GetUnmappedProviderHotelsV2Res
    • Unica.Core.Contracts.Models.HotelsAPI.HotelMappingV3.GetUpdatedCuratedContentRes
    • Unica.Core.Contracts.Models.HotelsAPI.HotelMappingV3.GetVervotechIdsRes
    • Unica.Core.Contracts.Models.HotelsAPI.HotelMappingV3.HotelProviderIdentifierV3
    • Unica.Core.Contracts.Models.HotelsAPI.HotelMappingV3.ProviderHotelIdsRes
    • Unica.Core.Contracts.Models.HotelsAPI.HotelMappingV3.ProviderMapping
    • Unica.Core.Contracts.Models.HotelsAPI.HotelMappingV3.ProviderMappingRes
    • Unica.Core.Contracts.Models.HotelsAPI.HotelMappingV3.StartMappingByFtpFolderRes
    • Unica.Core.Contracts.Models.Image
    • Unica.DataContracts.Common.Bed
    • Unica.DataContracts.Common.Contact
    • Unica.DataContracts.Common.Image
    • Unica.DataContracts.Common.PointOfInterest
    • RoomMappingRequest
    • Unica.Host.Web.Controllers.GetProviderNamesRes
    • HotelChains
    • LocationMapping
    • HotelBrands
    • Unica.Core.Contracts.Models.HotelsAPI.HotelMappingV3.GetProviderContentByVervotechIdsReq
    • schema2
    • Unica.Core.Contracts.Models.VerifyMapping
    • Unica.DataContracts.Common.CheckinInfo
    • Unica.DataContracts.Common.GuestReview
    • Unica.DataContracts.Common.UserReview
    • Unica.Services.CoreService.Models.HotelMappingReq
    • HotelMapping
    • NewHotelMapping
    • UpdatedHotelMapping
    • Unica.Core.Contracts.Models.HotelsAPI.HotelMappingV3.GetOSMLocationsRQ
    • DeletedHotelMapping
    • Unica.Core.Contracts.Models.MasterLocation.LocationMappingRes
    • Unica.Core.Contracts.Models.ProviderHotelHistory
    • Unica.DataContracts.Common.Address
    • Unica.DataContracts.Common.Room
    • ReviewHotels
    • ReviewMappingsofBookedHotelsRequest
    • Unica.Core.Contracts.Models.Billing.BillingEntry
    • MappedRoomRate
    • GetMasterRoomAmenitiesResponse
    • GetProviderContentResponse
    • GetProviderContentByHotelIdsResponse
    • Room
    • Unica.Core.Contracts.Models.ProviderMappingStats
    • Locations
    • Unica.DataContracts.MasterLocation.MasterLocation
    • Unica.Core.Contracts.Models.Room
    • RoomMappingBody2
    • ProviderMappingsStats
    • GetMasterRoomAttributesResponse
    • FacilityGroupFixtures
    • GetProviderHotelIdsByVervotechIdResponse
    • RoomMappingBody
    • Unica.Core.Contracts.Models.MappingStats
    • MappingsStats
    • HotelsByLocationIdRes
    • UnmappedHotelContent
    • Unica.DataContracts.HotelMappingV3.DTORawMapHotel
    • ProviderRoomContent
    • Unica.DataContracts.HotelMappingV3.ProviderHotel
    • RoomMappingResponse2
    • HotelContent
    • Unica.Core.Contracts.Models.RawMapHotel
    • CuratedHotels
    • CuratedHotelsWithLocationContent
    • Unica.Core.Contracts.Models.HotelsAPI.HotelMappingV3.CuratedHotelWithLocationMapping
    • Unica.Core.Contracts.Models.DownloadStats
  1. Mapping API

Map Rooms

POST
/api/2.0/mapping/rooms
Maps rooms from multiple providers for a single hotel into standardized room categories. Submit all rooms from different providers for a given hotel, each identified by a unique index. The API returns grouped room mappings with standardized names, bed types, views, and amenities.

Mapping rules#

Grouping behaviour is governed by the mapping rules configured on your account. Rules can merge bed types that you consider equivalent, treat view names as synonyms, suppress attributes that should not split a group, and more. They are set up by the Vervotech team or through the client portal, and they apply to every request by default.
Use the mappingRuleIds body field to additionally switch on any rule or account toggle that is configured as on demand rather than default. Selection is additive: your default rules always run, and naming a rule only adds to them. Omitting the field, or sending an empty array, leaves the account defaults in place rather than disabling them.

Request

Header Params

Body Params application/json

Examples

Responses

🟢200OK
application/json
Room Mapping Response
Bodyapplication/json

🟠403Forbidden
🔴500Internal Server Error
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://roommapping.vervotech.com/api/2.0/mapping/rooms' \
--header 'accountId: demoAccount' \
--header 'token: jansdv-859n kj2-nmsdv' \
--header 'correlationId: test123' \
--header 'culture: en-US' \
--header 'Content-Type: application/json' \
--data '{
    "vervotechHotelId": 201997202,
    "providerContentType": "Merged",
    "providerContentPreference": [
        "HotelBeds"
    ],
    "mappingRuleIds": [
        "DisableBedTypeGrouping",
        "BeddingMappingRule_2"
    ],
    "roomRates": [
        {
            "index": 1,
            "code": "201997202",
            "roomName": "Deluxe Room, 1 King Bed, Non Refundable",
            "description": "Deluxe Room, 1 King Bed, Non Refundable,full board",
            "provider": "HotelBeds",
            "providerHotelId": "18113069",
            "view": "Sea View",
            "nightlyPrice": 80,
            "currency": "USD",
            "boardBasis": "Full board",
            "refundability": "Non Refundable",
            "beds": [
                {
                    "count": 1,
                    "type": "Queen",
                    "size": "Queen",
                    "description": "1 Queen Bed"
                }
            ],
            "attributes": [
                {
                    "key": "HasBalcony",
                    "value": "Yes"
                }
            ]
        },
        {
            "index": 2,
            "code": "201997203",
            "roomName": "Deluxe Room, 1 King Bed, 1 KingBed, Refundable",
            "description": "Deluxe Room, 1 King Bed, 1 KingBed, Refundable",
            "provider": "HotelBeds",
            "providerHotelId": "18113069",
            "view": "Sea View",
            "nightlyPrice": 80,
            "currency": "USD",
            "boardBasis": "Breakfast",
            "refundability": "Refundable",
            "beds": [
                {
                    "count": 1,
                    "type": "twin",
                    "size": "twin",
                    "description": "1 twin Bed"
                }
            ],
            "attributes": [
                {
                    "key": "HasBalcony",
                    "value": "Yes"
                }
            ]
        },
        {
            "index": 3,
            "code": "201997204",
            "roomName": "Deluxe Room, 1 King Bed, 1 KingBed",
            "description": "Deluxe Room, 1 King Bed, 1 KingBed",
            "provider": "HotelBeds",
            "providerHotelId": "18113069",
            "view": "Sea View",
            "nightlyPrice": 80,
            "currency": "USD",
            "boardBasis": "",
            "refundability": "Refundable",
            "beds": [
                {
                    "count": 1,
                    "type": "king",
                    "size": "king",
                    "description": "1 king Bed"
                }
            ],
            "attributes": [
                {
                    "key": "HasBalcony",
                    "value": "Yes"
                }
            ]
        },
        {
            "index": 4,
            "code": "3",
            "roomName": "Habitación deluxe con balcón y vista al mar",
            "description": null,
            "provider": "DidaTravel",
            "providerHotelId": "561233",
            "beds": null,
            "view": null,
            "nightlyPrice": null,
            "currency": null,
            "attributes": null,
            "boardBasis": null,
            "refundability": "Refundable"
        }
    ]
}'
Response Response Example
200 - Success
{
    "success": true,
    "statusCode": 1000,
    "message": "Success",
    "standardRooms": [
        {
            "id": "1",
            "standardName": "Deluxe, King, Balcony",
            "masterTitle": "King Deluxe Room with Burj Khalifa View",
            "description": "A sea face room with air conditioning and extra rollaway beds available",
            "category": "Deluxe",
            "view": "Sea",
            "roomLocation": "Highfloor",
            "accommodationType": "Room",
            "addOn": "Club Access",
            "occupancyType": "Double",
            "bedroomCount": 1,
            "bedInfo": "King",
            "beds": [
                {
                    "type": "King",
                    "count": 1
                }
            ],
            "facilities": [
                {
                    "id": "1",
                    "name": "WiFi",
                    "masterFacilityId": "1"
                }
            ],
            "attributes": [
                {
                    "key": "HasBalcony",
                    "value": "Yes"
                }
            ],
            "mappedRoomRates": [
                {
                    "inputIndex": 1,
                    "roomCode": "201997202",
                    "boardBasis": "Full Board",
                    "refundability": "Non Refundable",
                    "matchScore": 92,
                    "cfs": 92,
                    "occupancyType": "Double",
                    "accommodationType": "Room",
                    "category": "Deluxe",
                    "view": "Sea",
                    "bedInfo": "1 King",
                    "attributes": []
                },
                {
                    "inputIndex": 2,
                    "roomCode": "201997203",
                    "boardBasis": "Bed and Breakfast",
                    "refundability": "Refundable",
                    "matchScore": 97,
                    "cfs": 97,
                    "attributes": []
                },
                {
                    "inputIndex": 3,
                    "roomCode": "201997204",
                    "boardBasis": "Unknown",
                    "refundability": "Refundable",
                    "matchScore": 97,
                    "cfs": 97,
                    "attributes": []
                }
            ],
            "providerRoomContent": {
                "roomName": "Deluxe Room, 1 King Bed, Non Refundable",
                "description": "Deluxe room with a sea facing balcony.",
                "views": "Sea View",
                "area": {
                    "squareFeet": "250",
                    "squareMeters": "23"
                },
                "facilities": [
                    {
                        "id": "1",
                        "name": "WiFi"
                    }
                ],
                "attributes": [
                    {
                        "key": "RoomSize",
                        "value": "200-250 SQFT"
                    }
                ],
                "images": [
                    {
                        "caption": "Deluxe Room",
                        "category": "Room",
                        "links": [
                            {
                                "providerHref": "https://images.example.com/deluxe_1000.jpg",
                                "disabled": false,
                                "size": "XXL"
                            }
                        ]
                    }
                ]
            }
        },
        {
            "standardName": "Deluxe, Balcony, Sea View",
            "category": "Deluxe",
            "view": "Sea",
            "bedInfo": "Unknown",
            "beds": [],
            "attributes": [],
            "warnings": [
                {
                    "code": "NON_ENGLISH_CONTENT_DETECTED",
                    "message": "Non-English text was detected in one or more room details. Please review the mapping results for accuracy."
                }
            ],
            "mappedRoomRates": [
                {
                    "inputIndex": 4,
                    "roomCode": "3",
                    "boardBasis": "Unknown",
                    "refundability": "Refundable",
                    "matchScore": 45,
                    "cfs": 45,
                    "attributes": []
                }
            ]
        }
    ]
}
Previous
References
Next
Get Master Room Amenities
Built with