Async Hotel Match

Poll async hotel-match job status

Overview

Returns the current progress and verdict counts for an async hotel-match job.

When to Use

  • Poll after submit - Call repeatedly until status is done or error

What You Get

  • Job counters - total, done, matched, review, no_match, and conflict-class counts
  • Terminal states - done means the result is ready (unless output_gcs was set); error includes an error message

Quick Start

Use the job_id from the submit response.

Rate limit: 50 requests/min (production), 10 requests/min (sandbox).

get/hotels/match/async/jobs/{jobId}/status

Request

  • Base URL
    https://api.liteapi.travel/v3.0
  • URL
    https://api.liteapi.travel/v3.0/hotels/match/async/jobs/{jobId}/status
  • Auth
    API key in header X-API-Key

Path parameters

jobIdstring uuid required

Job ID returned by POST /hotels/match/async

Response

Job status

job_idstring uuid required
status'queued' | 'running' | 'done' | 'error' required
totalinteger
doneinteger
matchedinteger
reviewinteger
no_matchinteger
geo_match_name_mismatchinteger
name_match_geo_mismatchinteger
errorstring
output_gcsstring
input_gcsstring
created_atstring date-time
updated_atstring date-time
total_chunksinteger
chunks_doneinteger

Example response

{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "queued",
  "total": 1500,
  "input_gcs": "gs://liteapi-mapping/hotelmatch/550e8400-e29b-41d4-a716-446655440000/input.csv",
  "total_chunks": 6
}

Changes

No recorded changes to this operation across all 1 revision of this API.