# Alibaba Cloud AirticketOpenAPI API

> Alibaba Cloud AirticketOpenAPI API on Apizie: 67 endpoints (Queries the account fund flow list, Recommends ancillary products, Creates a booking order, Cancels an unpaid order, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://zieapi.vercel.app/v1/cloud:aliyun-airticketopen/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:aliyun-airticketopen`
- Category: Cloud
- Status: byok
- Source: https://api.alibabacloud.com/product/airticketopen
- Page: https://zieapi.vercel.app/api/cloud/aliyun-airticketopen
- OpenAPI: https://zieapi.vercel.app/api/cloud/aliyun-airticketopen/openapi.json

Alibaba Cloud OpenAPI for AirticketOpenAPI (airticketopen, version 2023-01-17). Calls are signed with ACS3-HMAC-SHA256 using your AccessKey ID and secret.

## Endpoints

### Queries the account fund flow list
`GET https://zieapi.vercel.app/v1/cloud:aliyun-airticketopen/account-flow-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| utc_begin_time | integer | yes | The start search timestamp, effective to the day. Specify a 13-digit UTC timestamp |
| day_num | integer | yes | The number of days to search. Maximum value: 30. Valid values: 0 to 30 |
| page_index | integer | no | The page index |
| page_size | integer | no | The page size |
| x-acs-airticket-access-token | string | yes | access_token |
| x-acs-airticket-language | string | no | The language. Default value: the language configured for the buyer account |

### Recommends ancillary products
`POST https://zieapi.vercel.app/v1/cloud:aliyun-airticketopen/ancillary-suggest` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| solution_id | string | yes | The solution_id of the flight |
| x-acs-airticket-access-token | string | yes | The access_token |
| x-acs-airticket-language | string | no | The language setting. Defaults to the buyer account configuration |

### Creates a booking order
`POST https://zieapi.vercel.app/v1/cloud:aliyun-airticketopen/book` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| solution_id | string | yes | solution_id |
| out_order_num | string | yes | The external order number |
| contact | string | yes | The contact information (JSON-encoded) |
| passenger_list | string | yes | The passenger list (JSON-encoded) |
| passenger_ancillary_purchase_map_list | string | no | The passenger-ancillary purchase relationship (JSON-encoded) |
| x-acs-airticket-access-token | string | yes | access_token |
| x-acs-airticket-language | string | no | The language. The default value is the language configured for the buyer account |

### Cancels an unpaid order
`POST https://zieapi.vercel.app/v1/cloud:aliyun-airticketopen/cancel` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| order_num | integer | yes | The order number |
| x-acs-airticket-access-token | string | yes | access_token |
| x-acs-airticket-language | string | no | The language. The buyer account configuration is used by default |

### Submits a change application
`POST https://zieapi.vercel.app/v1/cloud:aliyun-airticketopen/change-apply` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| order_num | integer | yes | The order number |
| type | integer | yes | The change type. Valid values: 0: voluntary change 1: flight schedule change or flight cancellation |
| change_passenger_list | string | yes | The list of passengers for the change (JSON-encoded) |
| changed_journeys | string | yes | The target journey for the change (JSON-encoded) |
| contact | string | yes | The contact information for the change (JSON-encoded) |
| remark | string | no | The buyer remarks |
| x-acs-airticket-access-token | string | yes | The access_token |
| x-acs-airticket-language | string | no | The language setting. Defaults to the buyer account configuration |

### Cancels a change order
`POST https://zieapi.vercel.app/v1/cloud:aliyun-airticketopen/change-cancel` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| change_order_num | integer | yes | The change order number |
| x-acs-airticket-access-token | string | yes | access_token |
| x-acs-airticket-language | string | no | The language. By default, the language configured for the buyer account is used |

### Confirms a change order
`POST https://zieapi.vercel.app/v1/cloud:aliyun-airticketopen/change-confirm` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| change_order_num | integer | yes | The change order number |
| x-acs-airticket-access-token | string | yes | access_token |
| x-acs-airticket-language | string | no | The language. The default value is the language configured for the buyer account |

### Retrieves the details of a flight change order
`GET https://zieapi.vercel.app/v1/cloud:aliyun-airticketopen/change-detail` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| change_order_num | integer | yes | The change order number |
| x-acs-airticket-access-token | string | yes | The access_token |
| x-acs-airticket-language | string | no | The language. The buyer account configuration is used by default |

### Performs a paged query with paging parameters to retrieve a list of brief change order information for a…
`GET https://zieapi.vercel.app/v1/cloud:aliyun-airticketopen/change-detail-list-of-buyer` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| utc_create_begin | integer | no | The start time of change order creation, specified as a 13-digit UTC timestamp |
| utc_create_end | integer | no | The end time of change order creation, specified as a 13-digit UTC timestamp |
| page_index | integer | no | The page index |
| page_size | integer | no | The number of entries per page |
| x-acs-airticket-access-token | string | yes | access_token |
| x-acs-airticket-language | string | no | The language. By default, the language configured for the buyer account is used |

### Queries the list of change orders by the original order number
`GET https://zieapi.vercel.app/v1/cloud:aliyun-airticketopen/change-detail-list-of-order-num` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| order_num | integer | yes | The order number |
| page_index | integer | no | The page index |
| page_size | integer | no | The page size |
| x-acs-airticket-access-token | string | yes | The access token |
| x-acs-airticket-language | string | no | The language. Defaults to the buyer account configuration |

### Collects lowest-price flight information
`POST https://zieapi.vercel.app/v1/cloud:aliyun-airticketopen/collect-flight-lowest-price` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| lowest_price_flight_info_list | string | yes | The lowest-price flight information (JSON-encoded) |
| x-acs-airticket-access-token | string | yes | The access_token |
| x-acs-airticket-language | string | no | The language. Defaults to the buyer account configuration |

### Find richer quote information for the itinerary, including free baggage allowance, refund and change rules,…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-airticketopen/enrich` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| solution_id | string | no | solution_id returned by Search |
| adults | integer | no | Number of adult passengers 1-9 |
| children | integer | no | Number of child passengers 0-9 |
| infants | integer | no | Number of infant passengers 0-9 |
| cabin_class | string | no | Cabin class ALL_CABIN: all cabin classes; Y: economy; FC: first class and business class; S: premium economy; YS: economy and premium… |
| journey_param_list | string | no | Journey information (JSON-encoded) |
| x-acs-airticket-access-token | string | yes | access_token |
| x-acs-airticket-language | string | no | Multilingual, defaults to buyer account configuration |

### Uploads a file as an attachment image. The file size is limited to 300 KB or less
`POST https://zieapi.vercel.app/v1/cloud:aliyun-airticketopen/file-upload` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| order_num | integer | yes | The forward order number |
| file_content | string | yes | The Base64-encoded string of the attachment image file. Supported image types: .jpg, .png, and .jpeg |
| x-acs-airticket-access-token | string | yes | The access_token |
| x-acs-airticket-language | string | no | The language setting. Uses the buyer account configuration by default |

### Queries flight change information by order number
`GET https://zieapi.vercel.app/v1/cloud:aliyun-airticketopen/flight-change-of-order` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| order_num | integer | yes | The order number |
| x-acs-airticket-access-token | string | yes | access_token |
| x-acs-airticket-language | string | no | The multi-language setting. By default, the configuration of the buyer account is used |

### Obtains a token for API calls. The token is valid for 2 hours
`GET https://zieapi.vercel.app/v1/cloud:aliyun-airticketopen/get-token` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| app_key | string | yes | The appKey |
| app_secret | string | yes | The appSecret |

### Queries luggage through-check information for an itinerary
`GET https://zieapi.vercel.app/v1/cloud:aliyun-airticketopen/luggage-direct` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| flight_segment_param_list | string | no | The list of flight segments that constitute an itinerary. Maximum size: 2 (JSON-encoded) |
| x-acs-airticket-access-token | string | yes | The access token |
| x-acs-airticket-language | string | no | The language. Defaults to the buyer account configuration |

### Queries order details
`GET https://zieapi.vercel.app/v1/cloud:aliyun-airticketopen/order-detail` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| order_num | integer | no | The order number |
| out_order_num | string | no | The external order number |
| x-acs-airticket-access-token | string | yes | The access token |
| x-acs-airticket-language | string | no | The language. Defaults to the buyer account configuration |

### Queries the order list
`GET https://zieapi.vercel.app/v1/cloud:aliyun-airticketopen/order-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| book_time_start | integer | yes | The query start time. The value is a 13-digit UNIX timestamp |
| book_time_end | integer | yes | The query end time. The value is a 13-digit UNIX timestamp |
| status | integer | no | The order status. Valid values: 2: order creation succeeded. 3: order paid. 4: order succeeded. 5: order closed |
| page_index | integer | no | The page index. The value starts from 1 |
| page_size | integer | no | The page size |
| x-acs-airticket-access-token | string | yes | The access_token |
| x-acs-airticket-language | string | no | The language. Default value: the language configured for the buyer account |

### Verifies seat availability and pricing. If the price has changed, the developer can proceed with Book at the…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-airticketopen/pricing` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| solution_id | string | yes | solution_id |
| x-acs-airticket-access-token | string | yes | access_token |
| x-acs-airticket-language | string | no | The language. Defaults to the buyer account configuration |

### Submits a refund application for an air ticket
`POST https://zieapi.vercel.app/v1/cloud:aliyun-airticketopen/refund-apply` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| order_num | integer | yes | The order number |
| refund_type | string | yes | The refund type. Attachments are required for involuntary refund applications (JSON-encoded) |
| refund_passenger_list | string | yes | The list of passengers for the refund application (JSON-encoded) |
| refund_journeys | string | yes | The journeys for the refund application (JSON-encoded) |
| x-acs-airticket-access-token | string | yes | The access_token |
| x-acs-airticket-language | string | no | The language setting. Defaults to the buyer account configuration |

### Retrieves the details of a refund order
`GET https://zieapi.vercel.app/v1/cloud:aliyun-airticketopen/refund-detail` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| refund_order_num | integer | yes | The refund order number |
| x-acs-airticket-access-token | string | yes | The access_token |
| x-acs-airticket-language | string | no | The language. Defaults to the buyer account configuration |

### Queries the details of refund orders
`GET https://zieapi.vercel.app/v1/cloud:aliyun-airticketopen/refund-detail-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| order_num | integer | no | The order number |
| refund_create_begin_time | integer | yes | The start time for refund order creation. The value is a UTC timestamp |
| refund_create_end_time | integer | yes | The end time for refund order creation. The value is a UTC timestamp |
| page_index | integer | no | The page index |
| page_size | integer | no | The page size |
| x-acs-airticket-access-token | string | yes | The access_token |
| x-acs-airticket-language | string | no | The language. Defaults to the buyer account configuration |

### Searches for flight quotes and returns the lowest price across multiple flights. Note that the response of…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-airticketopen/search` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| cabin_class | string | no | The cabin class. Valid values: ALL_CABIN: all cabin classes. Y: economy class. FC: first class and business class. S: premium economy… |
| air_legs | string | yes | The journey array (JSON-encoded) |
| adults | integer | no | The number of adult passengers. Valid values: 1 to 9 |
| children | integer | no | The number of child passengers. Valid values: 0 to 9 |
| infants | integer | no | The number of infant passengers. Valid values: 0 to 9 |
| search_control_options | string | no | The search control options. This parameter is optional (JSON-encoded) |
| x-acs-airticket-access-token | string | yes | The access token |
| x-acs-airticket-language | string | no | The language. The default value is the language configured for the buyer account |

### Search and quote prices, currently providing the lowest price across multiple flights. Note that this API…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-airticketopen/standard-search` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| cabin_class | string | no | Defaults to ALL_CABIN if not specified. Cabin class ALL_CABIN: All cabin classes; Y: Economy class; FC: First class and Business class; S:… |
| air_legs | string | yes | Journey array. At least one of departure_city and departure_airport_list must be non-empty; when departure_airport_list has values, they… |
| adults | integer | no | Number of adult passengers, range 1-9 |
| children | integer | no | Number of child passengers, range 0-9 |
| infants | integer | no | Number of infant passengers, range 0-9 |
| search_control_options | string | no | Search control options, optional (JSON-encoded) |
| x-acs-airticket-access-token | string | yes | access_token |
| x-acs-airticket-language | string | no | Language setting, defaults to buyer account configuration |

### Requests a refund
`POST https://zieapi.vercel.app/v1/cloud:aliyun-airticketopen/ticket-apply-refund` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| DistributorOrderId | string | yes | The distributor order ID |
| RefundReason | string | yes | The refund reason |
| RefundRemark | string | no | The refund remark |
| AccountNo | integer | yes | The distributor account |

### Cancels an order
`POST https://zieapi.vercel.app/v1/cloud:aliyun-airticketopen/ticket-cancel-order` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| DistributorOrderId | string | yes | The distributor order ID |
| AccountNo | integer | yes | The distributor account |

### Checks refund eligibility
`POST https://zieapi.vercel.app/v1/cloud:aliyun-airticketopen/ticket-check-refund` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| DistributorOrderId | string | yes | The distributor order ID |
| RefundReason | string | yes | The reason for the refund |
| RefundRemark | string | no | The remarks for the refund |
| AccountNo | integer | yes | The distributor account number |

### Creates an order
`POST https://zieapi.vercel.app/v1/cloud:aliyun-airticketopen/ticket-create-order` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| DistributorOrderId | string | yes | The distributor order ID. This value must be unique |
| OrderProduct | string | yes | The ticket product (JSON-encoded) |
| Quantity | integer | yes | The purchase quantity |
| TotalDistributionPrice | string | yes | The total distribution price of the order (JSON-encoded) |
| Contact | string | yes | The contact person (JSON-encoded) |
| Travelers | string | no | The list of travelers (JSON-encoded) |
| AccountNo | integer | yes | The distributor account |

### Queries ticket products by paging
`POST https://zieapi.vercel.app/v1/cloud:aliyun-airticketopen/ticket-page-query-product` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| ScenicId | integer | no | The ID of the scenic spot |
| PageNo | integer | no | The page number |
| PageSize | integer | no | The number of entries per page |
| AccountNo | integer | yes | The account number of the distributor |

### Queries scenic spots with paging
`POST https://zieapi.vercel.app/v1/cloud:aliyun-airticketopen/ticket-page-query-scenic` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| PageNo | integer | no | The page number |
| PageSize | integer | no | The number of entries per page |
| AccountNo | integer | yes | The reseller account number |

### Pays an order
`POST https://zieapi.vercel.app/v1/cloud:aliyun-airticketopen/ticket-pay-order` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| DistributorOrderId | string | yes | The distributor order ID |
| AccountNo | integer | yes | The distributor account number |

### Queries an order
`POST https://zieapi.vercel.app/v1/cloud:aliyun-airticketopen/ticket-query-order` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| DistributorOrderId | string | yes | The distributor order ID |
| AccountNo | integer | yes | The distributor account number |

### Queries the ticket pricing inventory
`POST https://zieapi.vercel.app/v1/cloud:aliyun-airticketopen/ticket-query-price-stock` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| ProductId | string | yes | The product ID |
| StartDate | string | no | The start date of the query. Format: yyyy-MM-dd |
| EndDate | string | no | The end date of the query. Format: yyyy-MM-dd |
| AccountNo | integer | yes | The distributor account |

### Queries ticket products
`POST https://zieapi.vercel.app/v1/cloud:aliyun-airticketopen/ticket-query-product` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| ProductId | string | yes | The product ID |
| AccountNo | integer | yes | The distributor account |

### Queries refund orders
`POST https://zieapi.vercel.app/v1/cloud:aliyun-airticketopen/ticket-query-refund-order` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| DistributorOrderId | string | yes | The distributor order ID |
| AccountNo | integer | yes | The distributor account |

### Queries scenic spots
`POST https://zieapi.vercel.app/v1/cloud:aliyun-airticketopen/ticket-query-scenic` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| ScenicId | integer | yes | The ID of the scenic spot |
| AccountNo | integer | yes | The distributor account |

### Queries the shelves
`POST https://zieapi.vercel.app/v1/cloud:aliyun-airticketopen/ticket-query-shelf` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| ScenicId | integer | yes | The scenic spot ID |
| AccountNo | integer | yes | The distributor account |

### Processes payment and issues tickets
`POST https://zieapi.vercel.app/v1/cloud:aliyun-airticketopen/ticketing` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| order_num | integer | yes | The order number |
| x-acs-airticket-access-token | string | yes | access_token |
| x-acs-airticket-language | string | no | Specifies the language. By default, the language configuration of the buyer account is used |

### Performs a pre-ticketing check. This operation is optional
`POST https://zieapi.vercel.app/v1/cloud:aliyun-airticketopen/ticketing-check` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| order_num | integer | yes | The order number |
| x-acs-airticket-access-token | string | yes | access_token |
| x-acs-airticket-language | string | no | The language. Defaults to the buyer account configuration |

### Queries transit visa requirements for a flight itinerary. You provide flight information, and the API…
`GET https://zieapi.vercel.app/v1/cloud:aliyun-airticketopen/transit-visa` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| flight_segment_param_list | string | no | The list of flight segments that constitute an itinerary. Maximum size: 2 (JSON-encoded) |
| x-acs-airticket-access-token | string | yes | The access token |
| x-acs-airticket-language | string | no | The language. Defaults to the buyer account configuration |

### Applies for a refund
`POST https://zieapi.vercel.app/v1/cloud:aliyun-airticketopen/apply-refund` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| OrderNo | string | yes | The sales order number |
| RefundReason | string | no | The reason for the refund |
| AccountNo | integer | yes | The distributor account ID |
| TracerId | string | no | TraceId |

### Queries hotel details in batches
`POST https://zieapi.vercel.app/v1/cloud:aliyun-airticketopen/batch-get-hotel-detail` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| StandardHotelIds | string | yes | The list of standard hotel IDs. You can specify up to 100 IDs (JSON-encoded) |
| Language | string | no | The language, such as en or zh |
| AccountNo | integer | yes | The ID of the distributor account |
| TracerId | string | no | TraceId |

### Cancels or refunds an order
`POST https://zieapi.vercel.app/v1/cloud:aliyun-airticketopen/cancel-or-refund` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| OrderNo | string | yes | The sales order number |
| AccountNo | integer | yes | The distributor account ID |
| TracerId | string | no | TraceId |

### Cancels an order
`POST https://zieapi.vercel.app/v1/cloud:aliyun-airticketopen/cancel-order` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| OrderNo | string | yes | The sales order number |
| AccountNo | integer | yes | The distributor account ID |
| TracerId | string | no | TraceId |

### Creates an order and processes payment
`POST https://zieapi.vercel.app/v1/cloud:aliyun-airticketopen/create-and-pay` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| ItemOfferId | string | yes | The offer ID |
| Contact | string | yes | The contact information (JSON-encoded) |
| Guests | string | yes | The guests, grouped by room (JSON-encoded) |
| RoomCount | integer | yes | The number of rooms |
| ExternalOrderNo | string | no | The external order number |
| AccountNo | integer | yes | The reseller account ID |
| TracerId | string | no | TracerId |

### Creates an order
`POST https://zieapi.vercel.app/v1/cloud:aliyun-airticketopen/create-order` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| ItemOfferId | string | yes | The offer ID |
| Contact | string | yes | The contact information (JSON-encoded) |
| Guests | string | yes | The guests, grouped by room (JSON-encoded) |
| RoomCount | integer | yes | The number of rooms |
| ExternalOrderNo | string | no | The external order number |
| AccountNo | integer | yes | The reseller account ID |
| TracerId | string | no | TraceId |

### Applies for a refund
`POST https://zieapi.vercel.app/v1/cloud:aliyun-airticketopen/global-hotel-apply-refund` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| OrderNo | string | yes | The sales order number |
| RefundReason | string | no | The refund reason |
| AccountNo | integer | yes | The distributor account ID |
| TracerId | string | no | TraceId |

### Queries hotel details in batches
`POST https://zieapi.vercel.app/v1/cloud:aliyun-airticketopen/global-hotel-batch-get-hotel-detail` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| StandardHotelIds | string | yes | The list of standard hotel IDs. A maximum of 100 IDs are supported (JSON-encoded) |
| Language | string | no | The language for the response, such as en or zh |
| AccountNo | integer | yes | The ID of the distributor account |
| TracerId | string | no | string |

### Cancels or refunds an order
`POST https://zieapi.vercel.app/v1/cloud:aliyun-airticketopen/global-hotel-cancel-or-refund` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| OrderNo | string | yes | The sales order number |
| AccountNo | integer | yes | The distributor account ID |
| TracerId | string | no | TraceId |

### Cancels an order
`POST https://zieapi.vercel.app/v1/cloud:aliyun-airticketopen/global-hotel-cancel-order` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| OrderNo | string | yes | The sales order number |
| AccountNo | integer | yes | The distributor account ID |
| TracerId | string | no | TraceId |

### Creates an order and processes the payment
`POST https://zieapi.vercel.app/v1/cloud:aliyun-airticketopen/global-hotel-create-and-pay` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| ItemOfferId | string | yes | The offer ID |
| Contact | string | yes | The contact information (JSON-encoded) |
| Guests | string | yes | The guests grouped by room (JSON-encoded) |
| RoomCount | integer | yes | The number of rooms |
| ExternalOrderNo | string | yes | The external order number |
| AccountNo | integer | yes | The distributor account ID |
| TracerId | string | no | TraceId |

### Creates an order
`POST https://zieapi.vercel.app/v1/cloud:aliyun-airticketopen/global-hotel-create-order` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| ItemOfferId | string | yes | The offer ID |
| Contact | string | yes | The contact information (JSON-encoded) |
| Guests | string | yes | The guests grouped by room (JSON-encoded) |
| RoomCount | integer | yes | The number of rooms |
| ExternalOrderNo | string | yes | The external order number |
| AccountNo | integer | yes | The distributor account ID |
| TracerId | string | no | TraceId |

### Processes a distribution payment
`POST https://zieapi.vercel.app/v1/cloud:aliyun-airticketopen/global-hotel-pay` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| OrderNo | string | yes | The sales order number |
| AccountNo | integer | yes | The distributor account ID |
| TracerId | string | no | TraceId |

### Queries the availability of hotel rate plans
`POST https://zieapi.vercel.app/v1/cloud:aliyun-airticketopen/global-hotel-query-availability` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| StandardHotelIds | string | yes | The list of standard hotel IDs (JSON-encoded) |
| CheckInDate | string | yes | The check-in date in the format of yyyy-MM-dd |
| CheckOutDate | string | yes | The check-out date in the format of yyyy-MM-dd |
| AdultCount | integer | yes | The number of adults |
| ChildCount | integer | no | The number of children |
| ChildrenAges | string | no | The list of children's ages (JSON-encoded) |
| RoomCount | integer | yes | The number of rooms |
| AccountNo | integer | yes | The account ID of the distributor |
| TracerId | string | no | TraceId |

### Queries calendar-based rate availability for hotels in batch
`POST https://zieapi.vercel.app/v1/cloud:aliyun-airticketopen/global-hotel-query-calendar-availability` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| StandardHotelIds | string | yes | The list of standard hotel IDs on the platform. A maximum of 10 IDs are supported (JSON-encoded) |
| CheckInDateStart | string | yes | The start date of the check-in date range to query, in the yyyy-MM-dd format. The date cannot be earlier than the current day |
| CheckInDateEnd | string | yes | The end date of the check-in date range to query, in the yyyy-MM-dd format. The date cannot be earlier than the start date. The date range… |
| AdultCount | integer | yes | The number of adults |
| ChildCount | integer | no | The number of children |
| ChildrenAges | string | no | The list of children ages (JSON-encoded) |
| RoomCount | integer | yes | The number of rooms |
| AccountNo | integer | yes | The distributor account ID |
| TracerId | string | no | TraceId |

### Queries an order
`POST https://zieapi.vercel.app/v1/cloud:aliyun-airticketopen/global-hotel-query-order` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| OrderNo | string | no | The sales order number. At least one of OrderNo and ExternalOrderNo is required |
| ExternalOrderNo | string | no | The external order number. At least one of ExternalOrderNo and OrderNo is required |
| AccountNo | integer | yes | The distributor account ID |
| TracerId | string | no | TracerId |

### Queries city administrative divisions by paging (in Chinese and English)
`POST https://zieapi.vercel.app/v1/cloud:aliyun-airticketopen/global-hotel-search-city-page` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Start | integer | no | The pagination offset. Starts from 0 |
| Count | integer | yes | The number of entries per page |
| CountryCode | string | no | The country code in ISO 3166-1 alpha-2 format |
| AccountNo | integer | yes | The distributor account ID |
| TracerId | string | no | TraceId |

### Performs a paged query to retrieve the list of hotels by city with paging support
`POST https://zieapi.vercel.app/v1/cloud:aliyun-airticketopen/global-hotel-search-hotel-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| CityCode | string | yes | The city code |
| PageNo | integer | no | The page number. Pages start from 1 |
| PageSize | integer | no | The number of entries per page |
| AccountNo | integer | yes | The distributor account ID |
| TracerId | string | no | traceId |

### Validates the price of a hotel offer
`POST https://zieapi.vercel.app/v1/cloud:aliyun-airticketopen/global-hotel-validate-price` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| ItemOfferKey | string | yes | The offer key |
| RoomCount | integer | yes | The number of rooms |
| Adults | integer | yes | The total number of adults |
| Children | integer | no | The total number of children |
| ChildrenAges | string | no | The list of children's ages (JSON-encoded) |
| AccountNo | integer | yes | The distributor account ID |
| TracerId | string | no | TracerId |

### Processes a distribution payment
`POST https://zieapi.vercel.app/v1/cloud:aliyun-airticketopen/pay` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| OrderNo | string | yes | The sales order number |
| AccountNo | integer | yes | The distributor account ID |
| TracerId | string | no | TraceId |

### Queries hotel rate availability
`POST https://zieapi.vercel.app/v1/cloud:aliyun-airticketopen/query-availability` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| StandardHotelIds | string | yes | The list of standard hotel IDs (JSON-encoded) |
| CheckInDate | string | yes | The check-in date in the yyyy-MM-dd format |
| CheckOutDate | string | yes | The check-out date in the yyyy-MM-dd format |
| AdultCount | integer | no | The number of adults |
| ChildCount | integer | no | The number of children |
| ChildrenAges | string | no | The list of children's ages (JSON-encoded) |
| RoomCount | integer | no | The number of rooms |
| AccountNo | integer | yes | The ID of the distributor account |
| TracerId | string | no | TraceId |

### Queries calendar rates in batches
`POST https://zieapi.vercel.app/v1/cloud:aliyun-airticketopen/query-calendar-availability` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| StandardHotelIds | string | yes | The standard hotel IDs (JSON-encoded) |
| CheckInDateStart | string | yes | The start check-in date for the query (yyyy-MM-dd) |
| CheckInDateEnd | string | yes | The end check-in date for the query (yyyy-MM-dd) |
| AdultCount | integer | yes | The number of adults |
| ChildCount | integer | no | The number of children |
| ChildrenAges | string | no | The ages of the children (JSON-encoded) |
| RoomCount | integer | yes | The number of rooms |
| AccountNo | integer | yes | The distributor account ID |
| TracerId | string | no | TraceId |

### Queries an order
`POST https://zieapi.vercel.app/v1/cloud:aliyun-airticketopen/query-order` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| OrderNo | string | no | The sales order number. You must specify at least one of OrderNo and ExternalOrderNo |
| ExternalOrderNo | string | no | The external order number. You must specify at least one of OrderNo and ExternalOrderNo |
| AccountNo | integer | yes | The distributor account ID |
| TracerId | string | no | TracerId |

### Queries city administrative divisions in Chinese and English by using paging
`POST https://zieapi.vercel.app/v1/cloud:aliyun-airticketopen/search-city-page` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Start | integer | no | The pagination offset, starting from 0 |
| Count | integer | yes | The number of items per page |
| CountryCode | string | no | The country code in ISO 3166-1 alpha-2 format |
| AccountNo | integer | yes | The ID of the reseller account |
| TracerId | string | no | traceId |

### Queries a list of hotels by city using paging
`POST https://zieapi.vercel.app/v1/cloud:aliyun-airticketopen/search-hotel-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| CityCode | string | yes | The city code |
| PageNo | integer | no | The page number, starting from 1 |
| PageSize | integer | no | The number of entries per page |
| AccountNo | integer | yes | The ID of the distributor account |
| TracerId | string | no | traceId |

### Validates the price
`POST https://zieapi.vercel.app/v1/cloud:aliyun-airticketopen/validate-price` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| ItemOfferKey | string | yes | The offer key |
| RoomCount | integer | yes | The number of rooms |
| Adults | integer | yes | The number of adults per room |
| Children | integer | no | The number of children per room |
| ChildrenAges | string | no | The list of children's ages (JSON-encoded) |
| AccountNo | integer | yes | The distributor account ID |
| TracerId | string | no | traceId |

### version
`POST https://zieapi.vercel.app/v1/cloud:aliyun-airticketopen/version` (byok)

## Example
```
curl "https://zieapi.vercel.app/v1/cloud:aliyun-airticketopen/account-flow-list" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Alibaba Cloud AirticketOpenAPI API?
Create a free Apizie key, then send GET https://zieapi.vercel.app/v1/cloud:aliyun-airticketopen/account-flow-list with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Alibaba Cloud AirticketOpenAPI API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Alibaba Cloud AirticketOpenAPI itself also needs your own key from aliyuncs.com.

### Can AI agents use the Alibaba Cloud AirticketOpenAPI API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:aliyun-airticketopen.

### What is the status of the Alibaba Cloud AirticketOpenAPI API?
Needs your own provider key (bring your own key)