Skip to main content
POST
/
api
/
bookings
Create booking
curl --request POST \
  --url https://1a557de0-701c-477d-bedd-433520441dae.mock.pstmn.io/api/bookings \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "quoteId": "quote-123",
  "flightId": "QR001-20240101",
  "pieces": 10,
  "weight": 500,
  "commodity": "GEN",
  "shipper": {
    "name": "Example Corp",
    "address": "123 Main St, City, Country",
    "contact": "[email protected]"
  },
  "consignee": {
    "name": "Example Corp",
    "address": "123 Main St, City, Country",
    "contact": "[email protected]"
  },
  "awb": {
    "prefix": "157",
    "number": "157000001"
  },
  "routing": [
    {
      "from": "LAX",
      "to": "DOH",
      "carrier": "QR",
      "flightNumber": "QR001",
      "date": "2024-01-01"
    },
    {
      "from": "DOH",
      "to": "DXB",
      "carrier": "QR",
      "flightNumber": "QR123",
      "date": "2024-01-02"
    }
  ],
  "grossWeightKg": 500.5,
  "chargeableWeightKg": 520,
  "dimensionsCm": [
    {
      "l": 120.5,
      "w": 80,
      "h": 60,
      "pieces": 5
    },
    {
      "l": 100,
      "w": 70,
      "h": 50,
      "pieces": 5
    }
  ],
  "volume": 2.5,
  "shc": [
    "PER"
  ]
}
'
{
  "id": "booking-123",
  "quoteId": "quote-123",
  "status": "pending",
  "flightId": "QR001-20240101",
  "awbNumber": "15712345678",
  "createdAt": "2024-01-01T10:00:00Z"
}
Create a new booking with FFR fields and reference to quote.

​
Reference Documentation

For more information on booking creation workflows, please refer to:

Authorizations

​
Authorization
string
header
required

Body

application/json
​
quoteId
string
required

Quote identifier from the pricing response

Example:

"quote-123"

​
flightId
string
required

Flight identifier for the booking

Example:

"QR001-20240101"

​
pieces
integer
required

Number of pieces in the shipment

Example:

10

​
weight
number
required

Total weight in kilograms

Example:

500

​
commodity
string
required

Commodity code

Example:

"GEN"

​
shipper
object
required
​
consignee
object
required
​
awb
object
required
​
routing
object[]
required
Example:
[
  {
    "from": "LAX",
    "to": "DOH",
    "carrier": "QR",
    "flightNumber": "QR001",
    "date": "2024-01-01"
  },
  {
    "from": "DOH",
    "to": "DXB",
    "carrier": "QR",
    "flightNumber": "QR123",
    "date": "2024-01-02"
  }
]
​
grossWeightKg
number
required

Gross weight in kilograms

Example:

500.5

​
chargeableWeightKg
number
required

Chargeable weight in kilograms

Example:

520

​
dimensionsCm
object[]
required
Example:
[
  { "l": 120.5, "w": 80, "h": 60, "pieces": 5 },
  { "l": 100, "w": 70, "h": 50, "pieces": 5 }
]
​
volume
number

Total volume in cubic meters

Example:

2.5

​
shc
string[]

Special handling codes

Example:
["PER"]

Response

201 - application/json

Booking created

​
id
string
Example:

"booking-123"

​
quoteId
string
Example:

"quote-123"

​
status
enum<string>
Available options:
pending,
confirmed,
rejected,
cancelled
Example:

"pending"

​
flightId
string
Example:

"QR001-20240101"

​
awbNumber
string
Example:

"15712345678"

​
createdAt
string<date-time>
Example:

"2024-01-01T10:00:00Z"