Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mappingtravel.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

After starting a mapping job, use this endpoint to poll for its progress. The response includes the current status along with counts of matched, unmatched, and total hotels once the job has processed enough data to report them.

​
Request

GET https://api.mapping.travel/api/v1/mapping/{mappingJobId}
​
mappingJobId
string
required
UUID of the mapping job to retrieve. You receive this from the start mapping response.

​
Response

​
mappingJobId
string
required
UUID of the mapping job.
​
status
string
required
Current status of the job.
ValueDescription
PENDINGJob is queued and has not started yet.
RUNNINGJob is actively processing hotels.
COMPLETEDJob finished successfully. Results are available.
FAILEDJob encountered an error and did not complete.
​
mode
string
required
Mapping mode used for this job: STANDARD, ID_TO_ID, or HYBRID.
​
rowCount
number
Total number of hotels in the partner inventory. Available once the job begins processing.
​
matchedCount
number
Number of hotels successfully matched to a reference hotel. For HYBRID jobs, this is the combined count of ID-to-ID and fuzzy matches.
​
unmatchedCount
number
Number of hotels that could not be matched to any reference hotel.
​
partnerInventoryId
string
required
UUID of the partner inventory being mapped.
​
createdAt
string
required
ISO 8601 timestamp of when the job was created.
​
updatedAt
string
required
ISO 8601 timestamp of the last status update.

​
Error responses

StatusReason
401 UnauthorizedMissing or invalid Authorization header.
404 Not FoundNo mapping job with the given ID exists for your organization.
For HYBRID mode jobs, the matchedCount reflects matches from both phases — ID-to-ID matches completed in phase 1 plus any additional fuzzy matches from phase 2. The job stays in RUNNING until both phases complete.

​
Example

curl --request GET \
  --url https://api.mapping.travel/api/v1/mapping/f7e6d5c4-b3a2-1098-fedc-ba9876543210 \
  --header 'Authorization: Bearer <token>'

{
  "mappingJobId": "f7e6d5c4-b3a2-1098-fedc-ba9876543210",
  "status": "RUNNING",
  "mode": "HYBRID",
  "partnerInventoryId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "rowCount": 5000,
  "matchedCount": 3200,
  "unmatchedCount": null,
  "createdAt": "2026-04-25T09:00:00Z",
  "updatedAt": "2026-04-25T09:04:12Z"
}