Create Flight Order

Book the selected offer and pay with your Aisa balance. Always refresh the offer immediately before ordering.

POST https://api.aisa.one/apis/v1/duffel/flights/orders/create

Create Flight Order

cURL

curl --request POST \
  --url https://api.aisa.one/apis/v1/duffel/flights/orders/create \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "data": {
    "passengers": [
      {
        "born_on": "1987-07-24",
        "email": "[e-mail]",
        "family_name": "Earhart",
        "gender": "f",
        "given_name": "Amelia",
        "id": "pas_00009hj8USM7Ncg31cBCLL",
        "phone_number": "[phone]",
        "title": "mrs",
        "identity_documents": [
          {
            "expires_on": "2025-04-25",
            "issuing_country_code": "GB",
            "type": "passport",
            "unique_identifier": "19KL56147"
          }
        ],
        "infant_passenger_id": "pas_00009hj8USM8Ncg32aTGHL",
        "user_id": "icu_00009htyDGjIfajdNBZRlw"
      }
    ],
    "payments": [
      {
        "amount": "30.20",
        "currency": "GBP",
        "type": "balance",
        "three_d_secure_session_id": "3ds_0000AWr2XsTRIF1Vp34gh5"
      }
    ],
    "selected_offers": [
      "off_00009htyDGjIfajdNBZRlw"
    ],
    "metadata": {
      "payment_intent_id": "pit_00009htYpSCXrwaB9DnUm2"
    },
    "services": [
      {
        "id": "ase_00009hj8USM7Ncg31cB123",
        "quantity": 1
      }
    ],
    "type": "instant",
    "users": [
      "icu_00009htyDGjIfajdNBZRlw"
    ]
  }
}
'

201

{
  "data": {
    "available_actions": [
      "<string>"
    ],
    "booking_reference": "DJMT4D",
    "documents": [
      {
        "id": "<string>",
        "type": "electronic_ticket",
        "unique_id": "<string>"
      }
    ],
    "id": "ord_0000BAzrYIJiDdmFJKIhcy",
    "live_mode": true,
    "total_amount": "<string>",
    "total_currency": "<string>"
  }
}

Request contract

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

Complete OpenAPI definition

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

{
  "operationId": "post_duffel_orders_create",
  "method": "POST",
  "path": "/apis/v1/duffel/flights/orders/create",
  "servers": [
    {
      "url": "https://api.aisa.one"
    }
  ],
  "parameters": [],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "requestBody": {
    "content": {
      "application/json": {
        "schema": {
          "properties": {
            "data": {
              "properties": {
                "metadata": {
                  "description": "Metadata contains a set of key-value pairs that you can attach to an\nobject. It can be useful for storing additional information about the\nobject, in a structured format. Duffel does not use this information.\nYou should not store sensitive information in this field.\n\nThe metadata is a collection of key-value pairs, both of which are strings.\nYou can store a maximum of 50 key-value pairs, where each key has a maximum\nlength of 40 characters and each value has a maximum length of 500 characters.\n\nKeys must only contain numbers, letters, dashes, or underscores.\n",
                  "example": {
                    "payment_intent_id": "pit_00009htYpSCXrwaB9DnUm2"
                  },
                  "type": "object"
                },
                "passengers": {
                  "description": "The personal details of the passengers, expanding on the information initially provided when creating the offer request",
                  "items": {
                    "properties": {
                      "born_on": {
                        "description": "The passenger's date of birth",
                        "example": "1987-07-24",
                        "format": "date",
                        "type": "string"
                      },
                      "email": {
                        "description": "The passenger's email address",
                        "example": "[e-mail]",
                        "type": "string"
                      },
                      "family_name": {
                        "description": "The passenger's family name. Only `space`, `-`, `'`, and letters from the [`ASCII`](https://www.unicode.org/charts/PDF/U0000.pdf), [`Latin-1 Supplement`](https://www.unicode.org/charts/PDF/U0080.pdf) and [`Latin Extended-A`](https://www.unicode.org/charts/PDF/U0100.pdf) (with the exceptions of `Æ`, `æ`, `IJ`, `ij`, `Œ`, `œ`, `Þ`, and `ð`) Unicode charts are accepted. All other characters will result in a validation error. The minimum length is 1 or 2 characters, and the maximum, combined with `given_name`, is 40 characters. The requirements vary by airline. We recommend using a minimum length of 2.",
                        "example": "Earhart",
                        "type": "string"
                      },
                      "gender": {
                        "description": "The passenger's gender",
                        "enum": [
                          "m",
                          "f"
                        ],
                        "example": "f",
                        "type": "string"
                      },
                      "given_name": {
                        "description": "The passenger's given name. Only `space`, `-`, `'`, and letters from the [`ASCII`](https://www.unicode.org/charts/PDF/U0000.pdf), [`Latin-1 Supplement`](https://www.unicode.org/charts/PDF/U0080.pdf) and [`Latin Extended-A`](https://www.unicode.org/charts/PDF/U0100.pdf) (with the exceptions of `Æ`, `æ`, `IJ`, `ij`, `Œ`, `œ`, `Þ`, and `ð`) Unicode charts are accepted. All other characters will result in a validation error. The minimum length is 1 or 2 characters, and the maximum, combined with `family_name`, is 40 characters. The requirements vary by airline. We recommend using a minimum length of 2.",
                        "example": "Amelia",
                        "type": "string"
                      },
                      "id": {
                        "description": "The `id` of the passenger, returned when the [offer request](/docs/api/offer-requests) was created",
                        "example": "pas_00009hj8USM7Ncg31cBCLL",
                        "type": "string"
                      },
                      "identity_documents": {
                        "description": "The passenger's identity documents. You may only provide one identity document per type per passenger.\nThe identity document's type supported by the airline can be found in the offer's `supported_passenger_identity_document_types`.\nIf the offer's `passenger_identity_documents_required` is set to `true`, then a passport document must be provided.",
                        "items": {
                          "properties": {
                            "expires_on": {
                              "description": "Must only be provided for `passport` type. The date on which the identity document expires",
                              "example": "2025-04-25",
                              "format": "date",
                              "type": "string"
                            },
                            "issuing_country_code": {
                              "description": "Must only be provided for `passport`, `known_traveler_number`, and `passenger_redress_number` types. The [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) code of the country that issued this identity document",
                              "example": "GB",
                              "format": "ISO 3166-1 alpha-2",
                              "type": "string"
                            },
                            "type": {
                              "description": "The type of the identity document. Currently, the only supported types are `passport`, `tax_id`, `known_traveler_number`, and `passenger_redress_number`.\nThe identity document's type supported by the airline can be found in the offer's `supported_passenger_identity_document_types`.",
                              "enum": [
                                "passport",
                                "tax_id",
                                "known_traveler_number",
                                "passenger_redress_number"
                              ],
                              "example": "passport",
                              "type": "string"
                            },
                            "unique_identifier": {
                              "description": "The unique identifier of the identity document. e.g. the passport number.",
                              "example": "19KL56147",
                              "type": "string"
                            }
                          },
                          "required": [
                            "expires_on",
                            "issuing_country_code",
                            "type",
                            "unique_identifier"
                          ],
                          "title": "Order Request Passenger Identity Document",
                          "type": "object"
                        },
                        "type": [
                          "array",
                          "null"
                        ]
                      },
                      "infant_passenger_id": {
                        "description": "Infant passengers, with an `age` of 0 or 1, must be associated with an adult passenger. This field should be used to make this association. It should contain the `id` of the infant passenger as returned in the [offer request](/docs/api/offer-requests).",
                        "example": "pas_00009hj8USM8Ncg32aTGHL",
                        "type": "string"
                      },
                      "phone_number": {
                        "description": "The passenger's phone number in [E.164](https://www.twilio.com/docs/glossary/what-e164) (international) format",
                        "example": "[phone]",
                        "type": "string"
                      },
                      "title": {
                        "description": "The passenger's title (the `dr` title is not supported by certain airlines, where a [`ValidationError`](/docs/api/overview/response-handling) will be returned instead if used)",
                        "enum": [
                          "mr",
                          "ms",
                          "mrs",
                          "miss",
                          "dr"
                        ],
                        "example": "mrs",
                        "type": "string"
                      },
                      "user_id": {
                        "description": "Creates an association between the passenger and a previously created user.\n\nThis is intended to allow passengers the ability to manage their own orders.\n",
                        "example": "icu_00009htyDGjIfajdNBZRlw",
                        "type": "string"
                      }
                    },
                    "required": [
                      "id",
                      "given_name",
                      "family_name",
                      "gender",
                      "title",
                      "born_on",
                      "email",
                      "phone_number"
                    ],
                    "title": "Order Request Passenger",
                    "type": "object"
                  },
                  "type": "array"
                },
                "payments": {
                  "description": "The payment details to use to pay for the order. This key should be omitted when the order’s `type` is `hold`.",
                  "items": {
                    "properties": {
                      "amount": {
                        "description": "The amount of the payment. This should be the same as the `total_amount` of the offer specified in `selected_offers`, plus the `total_amount` of all the services specified in `services`.",
                        "example": "30.20",
                        "type": "string"
                      },
                      "currency": {
                        "description": "The currency of the `amount`, as an [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code. This should be the same as the `total_currency` of the offer specified in `selected_offers`.",
                        "example": "GBP",
                        "format": "ISO 4217",
                        "type": "string"
                      },
                      "three_d_secure_session_id": {
                        "description": "The `id` of the 3DSecure Session ID. This is the authentication when paying by [card](/docs/api/v2/card).",
                        "example": "3ds_0000AWr2XsTRIF1Vp34gh5",
                        "type": "string"
                      },
                      "type": {
                        "description": "The type of payment you want to apply to the order. If you are an IATA agent with your own agreements with airlines, in some cases, you can pay using ARC/BSP cash by specifying `arc_bsp_cash`.\nYou can pay using your Duffel account's balance by specifying `balance`. Otherwise, you can pay by [card](docs/api/v2/card). In [test mode](/docs/api/overview/test-mode), your balance is unlimited.\nIf you're not sure which of these options applies to you, get in touch with the Duffel support team at <[e-mail]>.",
                        "enum": [
                          "arc_bsp_cash",
                          "balance",
                          "card"
                        ],
                        "example": "balance",
                        "type": "string"
                      }
                    },
                    "required": [
                      "type",
                      "amount",
                      "currency"
                    ],
                    "type": "object"
                  },
                  "type": "array"
                },
                "selected_offers": {
                  "description": "The `id`s of the offers you want to book. You must specify an array containing exactly one selected offer.\n\nNote that you can only book one offer per offer request.\n",
                  "items": {
                    "example": "off_00009htyDGjIfajdNBZRlw",
                    "type": "string"
                  },
                  "type": "array"
                },
                "services": {
                  "description": "The services you want to book along with the first selected offer.\n\nIf the offer was priced with `intended_services`, you must either send those same\nservices here or omit this key entirely. Any other set of services is rejected.\n",
                  "items": {
                    "properties": {
                      "id": {
                        "description": "The `id` of the service from the offer's `available_services` that you want to book",
                        "example": "ase_00009hj8USM7Ncg31cB123",
                        "type": "string"
                      },
                      "quantity": {
                        "description": "The quantity of the service to book. This will always be `1` for seat services.",
                        "example": 1,
                        "minimum": 1,
                        "type": "integer"
                      }
                    },
                    "required": [
                      "id",
                      "quantity"
                    ],
                    "title": "Order Request Service",
                    "type": "object"
                  },
                  "type": "array"
                },
                "type": {
                  "description": "The type of order. You can only use `hold` with offers where `payment_requirements.requires_instant_payment` is `false`.\n\nWhen booking an offer with type `hold`, do not specify `payments` key.\n",
                  "enum": [
                    "instant",
                    "hold"
                  ],
                  "example": "instant",
                  "type": "string"
                },
                "users": {
                  "description": "The `id`s of users that would be allowed to manage the order.\n",
                  "items": {
                    "example": "icu_00009htyDGjIfajdNBZRlw",
                    "type": "string"
                  },
                  "type": "array"
                }
              },
              "required": [
                "selected_offers",
                "passengers",
                "payments"
              ],
              "title": "Body parameters",
              "type": "object"
            }
          },
          "required": [
            "data"
          ],
          "type": "object"
        }
      }
    },
    "required": true
  },
  "x-aisa-status": "enabled",
  "x-aisa-pricing": {
    "cost_contract": "response_usd",
    "customer_multiplier": 1.05,
    "customer_pricing": "provider_cost_multiplier",
    "default_request_estimate_usd": 315.0,
    "estimate_source": "profile_seed",
    "evidence_source": "response_body"
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "scheme": "bearer",
        "type": "http"
      }
    }
  }
}

Cost and request rules

Usage-based billing; Default request estimate: $315 USD (not a fixed price). 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): 315.0
• Cost contract: response_usd
• Published reference multiplier: 1.05
• Settlement evidence source: response_body

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

Order created with booking reference

data · object

Show child attributes