POST
/v2/cartCreate a cart
Hold a fare against the signed-in customer. The cart id drives every later step.
Bearer tokenAuthority: B2C_CART_CREATEhttps://booking.aerolink.dev
The cart is stamped with the authenticated customer as owner. Price already includes your storefront markup. Passengers are empty until you update the cart. facilities.cabinBaggage and checkinBaggage hold one entry per trip — a return booking has two.
cURL
bash
curl -X POST https://booking.aerolink.dev/v2/cart \
-H "Authorization: Bearer eyJ..." \
-H "Content-Type: application/json" \
-d '{"itineraryId":"66d2...","pricingIndex":0,"channel":"WEB"}'Headers
AuthorizationBearerrequired
Customer access token
Content-Typeapplication/jsonrequired
JSON body
AuthorizationBearer required | Customer access token |
Content-Typeapplication/json required | JSON body |
Request
JSON
{
"itineraryId": "66d2...",
"pricingIndex": 0,
"channel": "WEB"
}Body fields
itineraryIdstringrequired
Itinerary id, or a flightId — both are tried
pricingIndexnumberoptional
Which price group to book. Default 0.
channelenumrequired
ApplicationChannel, e.g. WEB
itineraryIdstring required | Itinerary id, or a flightId — both are tried |
pricingIndexnumber optional | Which price group to book. Default 0. |
channelenum required | ApplicationChannel, e.g. WEB |
Response
200
{
"message": "Success",
"data": {
"id": "66e1...",
"searchId": "9f2c...",
"price": { "currencyCode": "BDT", "total": 46300 },
"tripSummary": {
"tripType": "ONE_WAY",
"cabinType": "ECONOMY",
"airPlate": "EK",
"totalSegment": 1,
"firstPair": "DAC-DXB",
"tripDescriptions": [],
"lineItems": []
},
"passengers": [],
"facilities": {},
"finalPaymentDate": "2026-10-10T23:59:59"
}
}Response fields
idstringCart id, used by every later step
priceB2cFareLive fare, markup included
finalPaymentDatestringDeadline before the booking expires
idstring | Cart id, used by every later step |
priceB2cFare | Live fare, markup included |
finalPaymentDatestring | Deadline before the booking expires |
Errors
404Entity Not Found
No itinerary for itineraryId
401 / 403UNAUTHORIZED
Missing token or missing B2C_CART_CREATE
| HTTP | message | When |
|---|---|---|
| 404 | Entity Not Found | No itinerary for itineraryId |
| 401 / 403 | UNAUTHORIZED | Missing token or missing B2C_CART_CREATE |