List Mapping Jobs

Browse the mapping job history for your organization. Results are paginated and include the status and summary counts for each job. Use the returned mappingJobId values to fetch detailed status or search results.

Request

GET https://api.mapping.travel/api/v1/mapping

number

default:"0"

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

number

default:"20"

Number of jobs to return per page.

Response

object[]

required

Array of mapping job summaries for the current page.

Show job properties

string

required

UUID of the mapping job.

string

required

UUID of the partner inventory that was mapped.

string

required

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

string

required

Mapping mode used: STANDARD, ID_TO_ID, or HYBRID.

number

Total number of hotels in the inventory.

number

Number of hotels matched to a reference hotel.

number

Number of hotels that could not be matched.

string

required

ISO 8601 timestamp of when the job was created.

string

required

ISO 8601 timestamp of the most recent status update.

number

required

Total number of mapping jobs 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 available.

Error responses

Status	Reason
`401 Unauthorized`	Missing or invalid `X-API-Key` header.

Example

curl --request GET \
  --url 'https://api.mapping.travel/api/v1/mapping?page=0&size=20' \
  --header 'X-API-Key: <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
}

curl --request GET \
  --url 'https://api.mapping.travel/api/v1/mapping?page=0&size=20' \
  --header 'X-API-Key: <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
}

Inventory

Mapping

Reference Hotels

Suppliers

Webhooks

Export

Request

Response

Error responses

Example

​Request

​Response

​Error responses

​Example

Request

Response

Error responses

Example