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.
Use this endpoint to browse the mapping job history for your organization. Results are paginated and include the status and summary counts for each job. You can use the returned mappingJobId values to fetch detailed status or search results for individual jobs.
Request
GET https://api.mapping.travel/api/v1/mapping
Page number to retrieve. Pages are 0-indexed, so the first page is 0.
Number of jobs to return per page.
Response
Array of mapping job summaries for the current page. UUID of the partner inventory that was mapped.
Current job status: PENDING, RUNNING, COMPLETED, or FAILED.
Mapping mode used: STANDARD, ID_TO_ID, or HYBRID.
Total number of hotels in the inventory.
Number of hotels matched to a reference hotel.
Number of hotels that could not be matched.
ISO 8601 timestamp of when the job was created.
ISO 8601 timestamp of the most recent status update.
Total number of mapping jobs across all pages.
The current page number (0-indexed).
The number of results per page as requested.
Total number of pages available.
Error responses
Status Reason 401 UnauthorizedMissing or invalid Authorization header.
Example
curl --request GET \
--url 'https://api.mapping.travel/api/v1/mapping?page=0&size=20' \
--header 'Authorization: Bearer <token>'
{
"jobs" : [
{
"mappingJobId" : "f7e6d5c4-b3a2-1098-fedc-ba9876543210" ,
"partnerInventoryId" : "a1b2c3d4-e5f6-7890-abcd-ef1234567890" ,
"status" : "COMPLETED" ,
"mode" : "HYBRID" ,
"rowCount" : 5000 ,
"matchedCount" : 4750 ,
"unmatchedCount" : 250 ,
"createdAt" : "2026-04-25T09:00:00Z" ,
"updatedAt" : "2026-04-25T09:08:45Z"
},
{
"mappingJobId" : "c9d8e7f6-a5b4-3210-dcba-987654321098" ,
"partnerInventoryId" : "b2c3d4e5-f6a7-8901-bcde-f12345678901" ,
"status" : "COMPLETED" ,
"mode" : "STANDARD" ,
"rowCount" : 1200 ,
"matchedCount" : 1100 ,
"unmatchedCount" : 100 ,
"createdAt" : "2026-04-24T14:30:00Z" ,
"updatedAt" : "2026-04-24T14:42:10Z"
}
],
"totalJobs" : 47 ,
"page" : 0 ,
"size" : 20 ,
"totalPages" : 3
}