Order Create
Click here for full OrderCreate Technical Specification
The Order Create API is where a booking is created or held.
The service uses IATA NDC OrderCreateRQ & RS v16.1 schema
Although the Order Create API is stateless, it is recommended (and assumed) that it will be called as part of the following sequence of Shop and Order APIs
- AirShopping
- FlightPrice
- SeatAvailability (where advance seat selection is requested)
- OrderCreate
Version Information
The most recent version of the Order Create API is version 2. Previous versions are shown below.
| BA Version | IATA Version | Status | End-of-life date |
|---|---|---|---|
| v01 | 1.1.3 | Still supported | To be confirmed |
| v02 | 16.1 | Current Version | n/a |
API Endpoints
Order Create has a SOAP API endpoint.
The endpoints available are:
| Endpoint | URL |
|---|---|
| Live | https://api.ba.com/selling-distribution/OrderCreate/V2 |
| Test | https://test.api.ba.com/selling-distribution/OrderCreate/V2 |
API Methods
| Method | URL | Description |
|---|---|---|
| POST | /selling-distribution/OrderCreate/V2 | creates an order |
HTTP Headers
| Header Name | Description | Mandatory? | Example |
|---|---|---|---|
| client-key | Your unique key used to authorise access to the API. | Yes | n/a |
Search parameters
To view the search parameters for OrderCreate then please see the full OrderCreate technical specification
WSDL
Click here to see the OrderCreate WSDL
Response elements
The following error codes may be returned by the service
| OrderViewRS/InfoGroup/Error/Code | Meaning | Description |
|---|---|---|
| 200 | Ok | The request was successful and at least 1 item is being returned |
| 400 | Bad Request | Sent when the consumer sends a malformed request to the service. The actual error message is returned in the response body |
| 401 | Unauthorised | Returned when the consumer is not authenticated to use the REST API |
| 403 | Forbidden | Returned when the consumer is authenticated but does not have permission to access the Resource |
| 404 | Not found | Returned when no matching flights can be found e.g. request to get flight arrival information for a route we don't fly |
| 406 | Not Acceptable | Returned when the Accept header contains version / mime type info which we don't support |
| 500 | Internal Server Error | Something has gone wrong - please raise this as a bug with us |
| 503 | Service Unavailable | Returned when the server is temporarily unable to handle the request |
Supported Status Codes
You can view the standard status codes returned by our APIs here.