---
title: "Poll async hotel-match job status"
method: GET
path: "/hotels/match/async/jobs/{jobId}/status"
tags: ["Async Hotel Match"]
---

# Poll async hotel-match job status

`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`

## 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).

## Path parameters

- `jobId` string, uuid, required

## Response `200`

Job status

- JobStatus
  - `job_id` string, uuid, required
  - `status` 'queued' | 'running' | 'done' | 'error', required
  - `total` integer
  - `done` integer
  - `matched` integer
  - `review` integer
  - `no_match` integer
  - `geo_match_name_mismatch` integer
  - `name_match_geo_mismatch` integer
  - `error` string
  - `output_gcs` string
  - `input_gcs` string
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `total_chunks` integer
  - `chunks_done` integer

## Other responses

- `401`: Unauthorized
- `404`: Unknown job
- `429`: Rate limit exceeded
- `502`: Upstream mapping service unreachable
- `504`: Upstream mapping service timed out

---

[API](https://skmtc.dev/liteapi/apis/api-mapping.md) - [All operations](https://skmtc.dev/liteapi/apis/api-mapping/llms.txt) - [OpenAPI document](https://skmtc.dev/liteapi/apis/api-mapping/revisions/82f8d27a93af?raw)