Documents
Inspection Async Booking Result Guide
Latest Update Time: 2026-07-02 00:00:00
Use this API to check the result of an asynchronous inspection booking request submitted via Create Booking Asynchronously.
See the Inspection Introduction for base URL, authentication, and required headers.
Endpoint
GET https://ppapi.qima.com/booking-result/{requestId}
Prerequisites
In addition to the required headers and authentication setup:
- A
requestIdobtained from Create Booking Asynchronously
Path Parameters
| Parameter | Required | Description |
|---|---|---|
requestId | Yes | The request ID returned by Create Booking Asynchronously. |
Request Example
curl --location --request GET 'https://ppapi.qima.com/booking-result/<request-id>' \
--header 'Ai-Api-Access-Token: {your api access token}' \
--header 'Ai-User-Id: {your user ID}' \
--header 'Authorization: Bearer {your token}' \
--header 'Referer: https://preprodmy.qima.com/'
Successful Response
HTTP 200 OK returns the current status of the booking request. bookingInfo and orderInfo are stringified JSON blobs — parse them if you need the full submitted booking payload or the created order's details.
{
"message": null,
"content": {
"requestId": "E97EFEEBCAD647CCAAF4F123E889BC4E",
"orderNumber": "Q2600368591-PP",
"orderId": "8D21A68F78124F828E2232051E2712FD",
"status": "SUCCEED",
"clientRefNumber": "2107-0-041",
"comments": "Async place order successfully",
"companyId": "23EC09AB0F3C46BBA4F79718DCED16D0",
"userId": "4C6E94072DFC4918B60752F701DE544A",
"bookingInfo": "{\"referenceNumber\":\"2107-0-041\",\"serviceDate\":\"21-Dec-2026\",\"serviceType\":\"1\", ...}",
"orderInfo": "{\"orderGeneralInfo\":{\"orderId\":\"8D21A68F78124F828E2232051E2712FD\",\"orderNumber\":\"Q2600368591-PP\", ...}}",
"insertTime": "2026-07-02 15:13:00",
"updateTime": "2026-07-02 15:13:05"
}
}
bookingInfoandorderInfoare shown truncated above — each is a full JSON object serialized as a string.bookingInfomirrors the request body you submitted;orderInfomirrors the same booking-confirmation structure returned by Create an Inspection Booking (draft,orderGeneralInfo,orderExtra,orderFactory,orderSupplier,products).
Response Field Notes
| Field | Notes |
|---|---|
requestId | Matches the requestId you polled with. |
orderId / orderNumber | The created order's identifiers. Only meaningful once status is SUCCEED. |
status | One of PENDING (still processing — poll again), SUCCEED (booking created), or FAILED (booking failed — see comments). |
comments | Human-readable status message, e.g. the failure reason when status is FAILED. |
bookingInfo | The original booking request payload, as a JSON string. |
orderInfo | The created order's full details, as a JSON string, in the same shape as the Inspection Booking response content. null/absent while status is PENDING. |
Common Errors
See common authentication errors for 401 and 403 responses.
Next Steps
- Once
statusisSUCCEED, useorderIdwith Get Order Details or Cancel Booking.
