Create Order Change Request

Fetch change offers for a paid order. New slices must keep the original cabin class.

POST https://api.aisa.one/apis/v1/duffel/flights/order-change-requests/create

Reference example

text

# Fixed reference example. Playground inputs do not update this sample.
curl --request POST \
  --url https://api.aisa.one/apis/v1/duffel/flights/order-change-requests/create \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "data": {
    "order_id": "ord_0000A3bQ8FJIQoEfuC07n6"
  }
}'

201

{
  "data": {
    "id": "<string>",
    "order_change_offers": [
      {
        "change_total_amount": "<string>",
        "id": "<string>",
        "new_total_amount": "<string>",
        "penalty_total_amount": "<string>"
      }
    ]
  }
}

Request contract

• Method and path: POST /apis/v1/duffel/flights/order-change-requests/create
• Availability: enabled
• Request URL template: https://api.aisa.one/apis/v1/duffel/flights/order-change-requests/create
• Runtime facts: d0ae990bcd8ea1a75abd7e4a4e47260a24ab01e5c2b9d2fcc0366eae9f069f96

Complete OpenAPI definition

Effective request and pricing declaration (including authentication and referenced schemas):

{
  "operationId": "post_duffel_order_change_requests_create",
  "method": "POST",
  "path": "/apis/v1/duffel/flights/order-change-requests/create",
  "servers": [
    {
      "url": "https://api.aisa.one"
    }
  ],
  "parameters": [],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "requestBody": {
    "content": {
      "application/json": {
        "schema": {
          "properties": {
            "data": {
              "properties": {
                "order_id": {
                  "description": "The order ID you wish to change",
                  "example": "ord_0000A3bQ8FJIQoEfuC07n6",
                  "type": "string"
                },
                "private_fares": {
                  "additionalProperties": true,
                  "description": "The private fare codes for this order change request. The key is the airline's IATA code that provided the private fare code. The `corporate_code` and `tour_code` are provided to you by the airline and the `tracking_reference` is to identify your business by the airlines. The private fares for Order Change Requests work in much the same way as they do when searching for an offer request",
                  "example": {
                    "UA": [
                      {
                        "corporate_code": "1234",
                        "tour_code": "578DFL"
                      }
                    ]
                  }
                },
                "slices": {
                  "description": "The [slices](/docs/api/overview/key-concepts) that make up this offer request. One-way journeys can be expressed using one slice, whereas return trips will need two.",
                  "properties": {
                    "add": {
                      "description": "The search criteria for slices which you wish to add to your order",
                      "items": {
                        "description": "The search criteria for a slice to be added",
                        "properties": {
                          "cabin_class": {
                            "description": "The cabin that the passengers want to travel in",
                            "enum": [
                              "first",
                              "business",
                              "premium_economy",
                              "economy"
                            ],
                            "example": "economy",
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "departure_date": {
                            "description": "The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date on which the passengers want to depart",
                            "example": "2020-04-24",
                            "format": "date",
                            "type": "string"
                          },
                          "destination": {
                            "description": "The 3-letter IATA code for the city or airport where this slice ends",
                            "example": "JFK",
                            "type": "string"
                          },
                          "origin": {
                            "description": "The 3-letter IATA code for the city or airport where this slice starts",
                            "example": "LHR",
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "remove": {
                      "description": "The slices that you wish to remove from your order",
                      "items": {
                        "description": "The slice ID for the slice to be removed",
                        "properties": {
                          "slice_id": {
                            "description": "Duffel's unique identifier for the resource",
                            "example": "xxx_00009hthhsUZ8W4LxQgkjo",
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    }
                  },
                  "type": "object"
                }
              },
              "required": [
                "order_id"
              ],
              "title": "Body parameters",
              "type": "object"
            }
          },
          "required": [
            "data"
          ],
          "type": "object"
        }
      }
    },
    "required": true
  },
  "x-aisa-status": "enabled",
  "x-aisa-pricing": {
    "cost_contract": "explicit_zero",
    "customer_pricing": "fixed_success",
    "default_request_estimate_usd": 0.005,
    "estimate_source": "profile_seed",
    "evidence_source": "request_snapshot"
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "scheme": "bearer",
        "type": "http"
      }
    }
  }
}

Cost and request rules

Published reference price: $0.005 USD per successful request. Account-specific pricing and final settlement may differ.

Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.

• Default request reference estimate (USD): 0.005
• Cost contract: explicit_zero
• Settlement evidence source: request_snapshot

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

data · Body parameters · object · required

Show child attributes

Response

201

application/json

Change request with embedded change offers

data · object

Show child attributes