Get mapping job status and result counts

Retrieve the current status, rowCount, matchedCount, and unmatchedCount for a mapping job. Poll this endpoint until status is COMPLETED or FAILED.

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.

Value	Description
PENDING	Job is queued and has not started yet.
RUNNING	Job is actively processing hotels.
COMPLETED	Job finished successfully. Results are available.
FAILED	Job 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

Status	Reason
401 Unauthorized	Missing or invalid Authorization header.
404 Not Found	No 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

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

200 (running)

{
  "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"
}