Skip to main content
POST
/
api
/
airlines
/
{airlineCode}
/
bookings
Direct Airline Booking
curl --request POST \
  --url https://1a557de0-701c-477d-bedd-433520441dae.mock.pstmn.io/api/airlines/{airlineCode}/bookings \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "bookingReference": "BK-2025-001234",
  "shipper": {
    "name": "<string>",
    "address": "<string>",
    "contact": {
      "name": "<string>",
      "phone": "<string>",
      "email": "[email protected]"
    }
  },
  "consignee": {
    "name": "<string>",
    "address": "<string>",
    "contact": {
      "name": "<string>",
      "phone": "<string>",
      "email": "[email protected]"
    }
  },
  "routing": {
    "origin": "SIN",
    "destination": "LHR",
    "segments": [
      {
        "carrier": "SQ",
        "flightNumber": "SQ308",
        "departureDate": "2025-01-15",
        "from": "SIN",
        "to": "LHR",
        "allotmentCode": "FREE_SALE"
      }
    ]
  },
  "cargo": {
    "pieces": 10,
    "grossWeightKg": 250.5,
    "chargeableWeightKg": 300,
    "volumeCbm": 1.5,
    "commodity": {
      "code": "GEN",
      "description": "Electronics Equipment"
    },
    "specialHandling": [
      "ELI",
      "VAL"
    ],
    "dimensions": [
      {
        "pieces": 10,
        "length": 100,
        "width": 50,
        "height": 30,
        "unit": "CM"
      }
    ]
  },
  "quoteId": "QT-789",
  "awb": {
    "prefix": "157",
    "number": "12345678"
  },
  "serviceLevel": "PRIORITY",
  "bookingAgent": {
    "code": "ACA-123",
    "name": "Premium Cargo Agent"
  },
  "paymentTerms": "PREPAID",
  "remarks": "Handle with care - fragile electronics"
}
'
{
  "bookingId": "AL-BK-2025-987654",
  "status": "CONFIRMED",
  "airlineConfirmationNumber": "SQ-CONF-123456",
  "flightDetails": {
    "flightNumber": "SQ308",
    "departureDateTime": "2025-01-15T23:30:00Z",
    "arrivalDateTime": "2025-01-16T05:45:00Z",
    "capacity": {
      "allocated": 300,
      "unit": "KG"
    }
  },
  "message": "Booking confirmed with airline"
}

Reference Documentation

For more information on direct airline bookings, please refer to:

Authorizations

Authorization
string
header
required

Path Parameters

airlineCode
string
required

Airline code (IATA)

Body

application/json
bookingReference
string
required
Example:

"BK-2025-001234"

shipper
object
required
consignee
object
required
routing
object
required
cargo
object
required
quoteId
string
Example:

"QT-789"

awb
object
serviceLevel
string
Example:

"PRIORITY"

bookingAgent
object
paymentTerms
string
Example:

"PREPAID"

remarks
string
Example:

"Handle with care - fragile electronics"

Response

200 - application/json

Booking confirmed with airline

bookingId
string
Example:

"AL-BK-2025-987654"

status
string
Example:

"CONFIRMED"

airlineConfirmationNumber
string
Example:

"SQ-CONF-123456"

flightDetails
object
message
string
Example:

"Booking confirmed with airline"