Search Mapping Results

Explore the hotel-level results of a completed mapping job. Filter by hotel name, city, country, partner hotel ID, matched reference hotel ID, and supplier IDs. Each result includes the match confidence score, match method, and a map of external IDs from connected suppliers for the matched reference hotel.

All filters are optional and combinable. Omit any filter to return results regardless of that field’s value. Results are scoped to a single mapping job; cross-job search is not supported.

Only the documented filter fields are accepted: hotelName, city, country, partnerHotelId, matchedReferenceHotelId, supplierExternalIds, page, and size. Any unknown field in the request body is rejected with 400 Bad Request; check for typos in filter names.

Request

POST https://api.mapping.travel/api/v1/mapping/{mappingJobId}/results/search

string

required

UUID of the mapping job whose results you want to search.

string

Filters results where the partner hotel name contains this string. The match is case-insensitive.

string

Filters results to hotels in this city. Exact match, case-insensitive.

string

Filters results to hotels in this country. Exact match, case-insensitive.

string

Filters to a specific partner hotel by its ID. Exact match.

string

Filters to results matched to a specific reference hotel ID. Exact match.

object[]

List of { supplierId, externalId } objects. When provided, only results where the matched reference hotel has the given externalId for the given supplierId (a connected supplier’s UUID) are returned. Unmatched hotels are excluded when this filter is active.Each item has the shape:

{ "supplierId": "<supplier-uuid>", "externalId": "EXP-789" }

number

default:"0"

Page number to retrieve. 0-indexed.

number

default:"20"

Number of results per page.

Response

object[]

required

Array of matching hotel result records for the current page.

Show result properties

string

required

UUID of the mapping result record.

string

The partner’s own ID for this hotel, as provided in the uploaded inventory.

string

Name of the hotel from the partner inventory.

string

Street address from the partner inventory.

string

City from the partner inventory.

string

Country from the partner inventory.

string

ID of the reference hotel this partner hotel was matched to. null if the hotel was not matched.

string

Name of the matched reference hotel. null if unmatched.

number

Confidence score for the match, from 0 to 100. Higher values indicate a stronger match. null if the hotel was not matched.

string

How this hotel was matched.

Value	Description
`id_to_id`	Matched by exact supplier ID in the ID-to-ID phase.
`standard`	Matched by fuzzy name/address comparison.
`null`	Hotel was not matched.

object

required

Map of supplier UUID to the external ID that supplier uses for the matched reference hotel. Only populated for matched hotels. Empty object {} for unmatched hotels or when no supplier IDs are configured.

{
  "uuid-of-expedia": "EXP-789",
  "uuid-of-booking": "BK-101112"
}

string

required

ISO 8601 timestamp of when this result record was created.

string

required

ISO 8601 timestamp of the last update to this result record.

number

required

Total number of results matching the applied filters, across all pages.

number

required

The current page number (0-indexed).

number

required

The number of results per page as requested.

number

required

Total number of pages for the current result set.

Error responses

Status	Reason
`400 Bad Request`	Invalid pagination parameters (e.g., negative `page` or `size`).
`401 Unauthorized`	Missing or invalid `X-API-Key` header, or the mapping job belongs to a different organization.
`404 Not Found`	No mapping job with the given ID exists for your organization.

If you provide supplierExternalIds whose supplierId does not exist in the system, no error is returned. Those entries are silently skipped during enrichment, and results that only have external IDs for unknown suppliers will be excluded.

Example

curl --request POST \
  --url https://api.mapping.travel/api/v1/mapping/f7e6d5c4-b3a2-1098-fedc-ba9876543210/results/search \
  --header 'X-API-Key: <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "hotelName": "Hilton",
    "city": "Paris",
    "supplierExternalIds": [
      { "supplierId": "11111111-2222-3333-4444-555555555555", "externalId": "EXP-789" },
      { "supplierId": "66666666-7777-8888-9999-000000000000", "externalId": "BK-101112" }
    ],
    "page": 0,
    "size": 20
  }'

{
  "results": [
    {
      "id": "aaaabbbb-cccc-dddd-eeee-ffff00001111",
      "partnerHotelId": "partner-123",
      "partnerHotelName": "Hilton Paris Downtown",
      "partnerHotelAddress": "123 Rue de Rivoli",
      "partnerHotelCity": "Paris",
      "partnerHotelCountry": "France",
      "matchedReferenceHotelId": "ref-456",
      "matchedReferenceHotelName": "Hilton Paris Opera",
      "matchConfidence": 95.50,
      "matchMethod": "standard",
      "supplierExternalIds": {
        "11111111-2222-3333-4444-555555555555": "EXP-789",
        "66666666-7777-8888-9999-000000000000": "BK-101112"
      },
      "createdAt": "2026-04-25T09:08:45Z",
      "updatedAt": "2026-04-25T09:08:45Z"
    }
  ],
  "totalResults": 150,
  "page": 0,
  "size": 20,
  "totalPages": 8
}

{
  "error": "Bad Request",
  "message": "Page size must be greater than 0"
}

{
  "error": "Not Found",
  "message": "Mapping job not found"
}

curl --request POST \
  --url https://api.mapping.travel/api/v1/mapping/f7e6d5c4-b3a2-1098-fedc-ba9876543210/results/search \
  --header 'X-API-Key: <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "hotelName": "Hilton",
    "city": "Paris",
    "supplierExternalIds": [
      { "supplierId": "11111111-2222-3333-4444-555555555555", "externalId": "EXP-789" },
      { "supplierId": "66666666-7777-8888-9999-000000000000", "externalId": "BK-101112" }
    ],
    "page": 0,
    "size": 20
  }'

{
  "results": [
    {
      "id": "aaaabbbb-cccc-dddd-eeee-ffff00001111",
      "partnerHotelId": "partner-123",
      "partnerHotelName": "Hilton Paris Downtown",
      "partnerHotelAddress": "123 Rue de Rivoli",
      "partnerHotelCity": "Paris",
      "partnerHotelCountry": "France",
      "matchedReferenceHotelId": "ref-456",
      "matchedReferenceHotelName": "Hilton Paris Opera",
      "matchConfidence": 95.50,
      "matchMethod": "standard",
      "supplierExternalIds": {
        "11111111-2222-3333-4444-555555555555": "EXP-789",
        "66666666-7777-8888-9999-000000000000": "BK-101112"
      },
      "createdAt": "2026-04-25T09:08:45Z",
      "updatedAt": "2026-04-25T09:08:45Z"
    }
  ],
  "totalResults": 150,
  "page": 0,
  "size": 20,
  "totalPages": 8
}

{
  "error": "Bad Request",
  "message": "Page size must be greater than 0"
}

{
  "error": "Not Found",
  "message": "Mapping job not found"
}

Inventory

Mapping

Reference Hotels

Suppliers

Webhooks

Export

Request

Response

Error responses

Example

​Request

​Response

​Error responses

​Example

Request

Response

Error responses

Example