List all mapping jobs for your organization

Retrieve a paginated list of all mapping jobs for your organization. Each item includes the job status, mode, matched count, and unmatched count.

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 · default: "0"

Page number to retrieve. Pages are 0-indexed, so the first page is 0.

size · number · default: "20"

Number of jobs to return per page.

Response

jobs · object[] · required

Array of mapping job summaries for the current page.

Show job properties

mappingJobId · string · required

UUID of the mapping job.

partnerInventoryId · string · required

UUID of the partner inventory that was mapped.

status · string · required

Current job status: PENDING, RUNNING, COMPLETED, or FAILED.

mode · string · required

Mapping mode used: STANDARD, ID_TO_ID, or HYBRID.

rowCount · number

Total number of hotels in the inventory.

matchedCount · number

Number of hotels matched to a reference hotel.

unmatchedCount · number

Number of hotels that could not be matched.

createdAt · string · required

ISO 8601 timestamp of when the job was created.

updatedAt · string · required

ISO 8601 timestamp of the most recent status update.

totalJobs · number · required

Total number of mapping jobs across all pages.

page · number · required

The current page number (0-indexed).

size · number · required

The number of results per page as requested.

totalPages · number · required

Total number of pages available.

Error responses

Status	Reason
401 Unauthorized	Missing or invalid Authorization header.

Example

cURL

curl --request GET \
  --url 'https://api.mapping.travel/api/v1/mapping?page=0&size=20' \
  --header 'Authorization: Bearer <token>'

200

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