Service List
Click here for full ServiceList Technical Specification
The Service List API returns a list of all applicable services along with their price for all flights in the order.
The service uses IATA NDC ServiceListRQ & RS v16.1 schema
The Service List API is stateless
Version Information
The most recent version of the Service List API is version 2. Previous versions are shown below.
| Version | Status | Enhancements | End-of-life date |
|---|---|---|---|
| v01 | Still supported | returns a list of requestable services | to be advised |
API Endpoints
Service List has a SOAP API endpoint.
The endpoints available are:
| Endpoint | URL |
|---|---|
| Live | n/a |
| Test | https://test.api.ba.com/selling-distribution/ServiceList/V2 |
API Methods
| Method | URL | Description |
|---|---|---|
| POST | /selling-distribution/ServiceList/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
The various search parameters are described below:
| Name | Description | Format | Mandatory / optional | Example | Allowed values |
|---|---|---|---|---|---|
| ServiceListRQ | |||||
| @Version attribute | message version | mandatory | 2.0 | ||
| @PrimaryLangID attribute | o | EN | any | ||
| @AltLangID attribute | o | EN | any | ||
| Document | |||||
| Name | NDC Implementation Name | mandatory | BA | any - no validation performed | |
| Party/Sender/TravelAgencySender | |||||
| Name | Sender name | alphabetic | m | Travel Agent plc | any |
| IATA_Number | the IATA number of the agent that created the order | numeric | mandatory (either) | use your own IATA or non-IATA number | any |
| OtherIDs/OtherID | the non-IATA number of the agent that created the order | ||||
| AgencyID | Agency ID | alphanumeric | m | this can be the same as Name | any |
| Party/Participants/Participant: Note: Populate Participant tag only if the calling client is an Aggregator or GDS | |||||
| @SequenceNumber attribute | sequence number of this participant in the message flow | numeric | m | 1 | add 1 to the highest Participant@SequenceNumber |
| Name | Participant name | alphabetic | o | aggregator plc | any |
| AggregatorID | Participant ID | alphanumeric | m | Example: 00123456 | Aggregator ID provided by BA.The service validates this ID and allow only if the AggregatorID provided is valid |
| Query | |||||
| OrderID | existing order reference | string | optional | ||
Search parameters may be submitted in any order and are case insensitive.
Response elements
The following error codes may be returned by the service
| ServiceListRS/ 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 |
Supported Status Codes
You can view the standard status codes returned by our APIs here.