1. Ancillary booking APIs
PKFARE Flight Buyer API
  • Guides
    • Quick Start
    • Tricks for Playing with PKFARE API
    • Book air tickets with ancillaries
    • Raise refund requests
    • Raise change requests
    • Receive flight rescheduled notification
    • Add Paid Bags after the Booking
    • Branded Fare Integration Guide
  • API Reference
    • Air ticket booking APIs
      • TicketIssuanceNotify_V2
      • Shopping V10
      • PrecisePricing V12
      • Penalty V4
      • PreciseBooking V8
      • CancelOrder
      • OrderPricing V6
      • Ticketing
      • OrderDetail V14
      • RequestTicketing
      • ModifyOrderStatus
    • Ancillary booking APIs
      • AncillaryStatusPush
      • AncillaryPricing V6
        POST
      • AncillaryBooking
        POST
      • CancelAncillaryOrder
        POST
      • AncillaryTicketing
        POST
      • AncillaryOrderDetail
        POST
    • Flight schedule change APIs
      • ScheduleChangeNotify
      • GetScheduleChangeReply
      • GetScheduleChangeList
      • AcknowledgeScheduleChange
      • AcceptScheduleChange
    • Refund APIs
      • RefundResultNotify
      • ReimbursedResultNotify
      • Refund Pricing
      • CheckRefundPricing
      • RefundRequest
      • CheckRefund
      • CheckReimbursed
      • DownloadAttachmentFile API
      • UploadAttachmentFile API
    • Change APIs
      • ChangeResultPush
      • Change Reshop
      • Change Request
      • Change Passenger Info
      • Change Reprice
      • ChangeRepricePush
    • Void APIs
      • ReimbursedResultPush
      • VoidRequest
    • Cache APIs
      • CacheShopping
      • ValidateItinerary API
    • APIs with all versions
      • CheckInInfoPush
      • Raise change requests Copy
      • Shopping
        • Shopping
        • Shopping_V2
        • Shopping_V4
        • Shopping V7
        • Shopping V9
        • Shopping V8
      • PrecisePricing
        • PrecisePricing
        • PrecisePricing_V2
        • PrecisePricing_V6
        • PrecisePricing V9
        • PrecisePricing V10
        • PrecisePricing V11
      • Penalty
        • Penalty
        • Penalty V2
        • Penalty V3
      • PreciseBooking
        • PreciseBooking
        • PreciseBooking_V2
        • PreciseBooking_V5
        • PreciseBooking V6
        • PreciseBooking V7
      • OrderPricing
        • OrderPricing_V2
        • OrderPricing V4
        • OrderPricing V5
      • Ticketing
        • Ticketing
      • TicketNumPush
        • TicketingNumPush
        • TicketingNumPush_V2
        • TicketingNumPush_V3
        • TicketIssuanceNotify
      • CancelOrder
        • CancelOrder
      • OrderDetail
        • OrderDetail_V2
        • OrderDetail_V3
        • OrderDetail_V4
        • OrderDetail_V5
        • Json_OrderDetail_V7
        • Json_OrderDetail_V8
        • OrderDetail V9
        • OrderDetail V13
      • AncillaryPricing
        • AncillaryPricing
        • AncillaryPricing V5
      • AncillaryBooking
        • AncillaryBooking
      • CancelAncillaryOrder
        • CancelAncillaryOrder
      • AncillaryTicketing
        • AncillaryTicketing_V2
      • AncillaryStatusPush
        • AncillaryStatusPush
      • AncillaryOrderDetail
        • AncillaryOrderDetail
      • RequestTicketing
        • RequestTicketing
      • ScheduleChangeNotify
        • ScheduleChangeNotify
      • GetScheduleChangeList
        • GetScheduleChangeList
      • AcknowledgeScheduleChange
        • AcknowledgeScheduleChange
      • AcceptScheduleChange
        • AcceptScheduleChange
      • GetScheduleChangeReply
        • GetScheduleChangeReply
      • RefundPricing
        • RefundPricing
      • CheckRefundPricing
        • CheckRefundPricing
      • RefundRequest
        • RefundRequest
      • RefundResultNotify
        • RefundResultNotify
      • CheckRefund
        • CheckRefund
      • ReimbursedResultNotify
        • ReimbursedResultNotify
      • CheckReimbursed
        • CheckReimbursed
      • UploadAttachmentFile
        • UploadAttachmentFile
      • DownloadAttachmentFile
        • DownloadAttachmentFile
      • ChangeReshop
        • ChangeReshop
      • ChangeRequest
        • ChangeRequest
      • ChangePassengerInfo
        • ChangePassengerInfo
      • VoidRequest
        • VoidRequest
        • VoidRequest_V2
      • ReimbursedResultPush
        • ReimburseResultPush_V2
  • Development Instructions
    • Signature
    • Order Status Explanation
    • Booking errors explanation and suggestions
    • Price Breakdown Explanation
    • Airlines available from PKFARE
    • PKFARE Operation Notice
    • How to retrieve airlines'PNR and ticket numbers
    • PKFARE Buyer API solutionId Usage Guide
  • Notice
    • Release Note
  • Schemas
    • Schemas
      • ShoppingReq
      • Result«ShoppingResult»
      • Authentication
      • SearchDTO
      • JourneysDTO_1
      • PassengersDTO
      • ShoppingResult
      • SegmentsDTO
      • SolutionsDTO
      • BaggageDTO
      • ConditionsDTO
      • ChangeDTO
      • OtherDTO
      • RefundDTO
      • JourneysDTO
      • SegmentInfoDTO
  1. Ancillary booking APIs

AncillaryPricing V6

POST
/json/ancillaryPricingV6

Function#

Through AncillaryPricing API, you can search ancillary products and get product details.
Paid baggage and seat selection are available in the initial booking. It is able to search multiple ancillary products at the
same time or search them separately.
The passengers and journeys are required when adding ancillary in the inital booking. The request structure of
AncillaryPricing is the same as that of PrecisePricing. It is necessary to use PrecisePricing service before using this
interface. The whole process should be limited to 30 mins.
Additionally, paid baggage is also available in the postbooking process. The air order number is required in the
Ancillarypricing request when adding ancillary after the booking. AncillaryPricing Results are valid within half an hour.

Versioning#

VersionSandbox Invoking AddressUpdate
ancillaryPricinghttps://api.pkfare.com/ancillaryPricingSupport in-booking paid baggage
ancillaryPricing_V3https://api.pkfare.com/ancillaryPricingV3Support in-booking seat selection
ancillaryPricing_V4https://api.pkfare.com/ancillaryPricingV4Support postbooking paid bag
ancillaryPricing_V5https://api.pkfare.com/ancillaryPricingV5Add solutionId to enhance tracebility and visibility
ancillaryPricing_V5(json format)https://api.pkfare.com/json/ancillaryPricingV5Add solutionId to enhance tracebility and visibility;Support json formatted requesting parameter
ancillaryPricing_V6(json format)https://api.pkfare.com/json/ancillaryPricingV6New feature: now support shopping and booking prices for different product tags, including PKFARE-defined special product types and airline-standard branded fares, etc. and support ancillary pricing for passengers traveling with infants
Below is the most updated version

Request Example#

1.
One-Way Journey (Search Baggage)
{
    "authentication": {
        "partnerId":"partnerId",
        "sign":"sign"
    },
    "pricing": {
        "adults": 1,
        "children": 0,
        "infants": 1,
        "ancillary": [
            1
        ],
        "solutionId": "1",
        "journeys": {
            "journey_0": [
                {
                    "airline":"TR",
                    "arrival":"HKG",
                    "arrivalDate":"2022-04-23",
                    "arrivalTime":"10:05",
                    "bookingCode":"O",
                    "departure":"SIN",
                    "departureDate":"2022-04-23",
                    "departureTime":"06:00",
                    "flightNum":"980"
                }
            ]
        }
    }
}
2.
One-Way Journey(Search Seat)
{
    "authentication": {
        "partnerId":"partnerId",
        "sign":"sign"
    },
    "pricing": {
        "adults": 1,
        "children": 0,
        "infants": 0,
        "ancillary": [
            2
        ],
        "solutionId": "1",
        "journeys": {
            "journey_0": [
                {
                    "airline":"TR",
                    "arrival":"HKG",
                    "arrivalDate":"2022-04-23",
                    "arrivalTime":"10:05",
                    "bookingCode":"O",
                    "departure":"SIN",
                    "departureDate":"2022-04-23",
                    "departureTime":"06:00",
                    "flightNum":"980"
                }
            ]
        }
    }
}
3.Round Journey (Search Baggage)
{
    "authentication": {
        "partnerId":"partnerId",
        "sign":"sign"
    },
    "pricing": {
        "adults": 1,
        "children": 0,
        "infants": 0,
        "ancillary": [
            1
        ],
        "solutionId": "1",
        "journeys": {
            "journey_0": [
                {
                    "airline":"TR",
                    "arrival":"HKG",
                    "arrivalDate":"2022-04-23",
                    "arrivalTime":"10:05",
                    "bookingCode":"O",
                    "departure":"SIN",
                    "departureDate":"2022-04-23",
                    "departureTime":"06:00",
                    "flightNum":"980"
                }
            ],
            "journey_1": [
                {
                    "airline":"TR",
                    "arrival":"SIN",
                    "arrivalDate":"2022-04-25",
                    "arrivalTime":"14:50",
                    "bookingCode":"W",
                    "departure":"HKG",
                    "departureDate":"2022-04-25",
                    "departureTime":"10:55",
                    "flightNum":"981"
                }
            ]
        }
    }
}
4.
Round Journey (Search Baggage And Seat)
{
    "authentication": {
        "sign": "sign",
        "partnerId": "partnerId"
    },
    "pricing": {
        "journeys": {
            "journey_1": [
                {
                    "departureTime": "09:20",
                    "flightNum": "625",
                    "arrival": "SGN",
                    "arrivalTime": "10:45",
                    "bookingCode": "S",
                    "departure": "DAD",
                    "departureDate": "2023-12-10",
                    "airline": "VJ",
                    "arrivalDate": "2023-12-10"
                },
                {
                    "departureTime": "19:00",
                    "flightNum": "895",
                    "arrival": "DEL",
                    "arrivalTime": "22:50",
                    "bookingCode": "S",
                    "departure": "SGN",
                    "departureDate": "2023-12-10",
                    "airline": "VJ",
                    "arrivalDate": "2023-12-10"
                }
            ],
            "journey_0": [
                {
                    "departureTime": "00:05",
                    "flightNum": "896",
                    "arrival": "SGN",
                    "arrivalTime": "06:20",
                    "bookingCode": "I",
                    "departure": "DEL",
                    "departureDate": "2023-11-30",
                    "airline": "VJ",
                    "arrivalDate": "2023-11-30"
                },
                {
                    "departureTime": "17:20",
                    "flightNum": "632",
                    "arrival": "DAD",
                    "arrivalTime": "18:35",
                    "bookingCode": "I",
                    "departure": "SGN",
                    "departureDate": "2023-11-30",
                    "airline": "VJ",
                    "arrivalDate": "2023-11-30"
                }
            ]
        },
        "children": "1",
        "solutionId": "1",
        "adults": "2",
        "infants": 1,
        "ancillary": [
            1,
            2
        ]
    }
}
 
5. Open Jaw (Search Baggage)
{
    "authentication": {
        "partnerId":"partnerId",
        "sign":"sign"
    },
    "pricing": {
        "adults": 1,
        "children": 0,
        "infants": 1,
        "ancillary": [
            1
        ],
        "solutionId": "1",
        "journeys": {
            "journey_0": [
                {
                    "airline":"TR",
                    "arrival":"HKG",
                    "arrivalDate":"2022-04-23",
                    "arrivalTime":"10:05",
                    "bookingCode":"O",
                    "departure":"SIN",
                    "departureDate":"2022-04-23",
                    "departureTime":"06:00",
                    "flightNum":"980"
                }
            ],
            "journey_1": [
                {
                    "airline":"TR",
                    "arrival":"CNX",
                    "arrivalDate":"2022-04-25",
                    "arrivalTime":"14:50",
                    "bookingCode":"W",
                    "departure":"HKG",
                    "departureDate":"2022-04-25",
                    "departureTime":"10:55",
                    "flightNum":"981"
                }
            ]
        }
    }
}
6.
Search Postbooking Baggage
{
    "authentication": {
        "sign": "sign",
        "partnerId": "partnerId"
    },
    "pricing": {
        "airOrderNum": "917049521951368301",
        "ancillary": [
            1
        ]
    }
}

Error Code List#

errorCodeerrorMsgDescription
0okRequest has been processed successfully.
S001System errorSystem error.
P001XXX is illegalParameter is illegal.
P002XXX is missingParameter is missing.
P006Invalid parameterWrong parameter, please check.
B002Partner is not existsPartner ID does not exist.
B003Illegal signIllegal sign, please check your signature.
B005Can not find any matching precisePricing result within 30 minutesCan not find the corresponding precisePricing record. Please check the itinerary and passenger numbers. AncillaryPricing has to be invoked within 30 minutes after pricing.
B009Order status is invalidair order status doesn't meet the requirement.
B010The order was not found.The air order number was not correct.
B069AncillaryPricing is offline-1The AncillaryPricing API is offline, please contact PKFARE to enable it.
B070No ancillary price on this routingNo ancillary price for this routing.
B085The journey infomation of AncillaryPricing is not consistent with that of air orderThe journey infomation of AncillaryPricing is not correct
B086The number of ancillary passenger type outnumbers that of air order.The number of ancillary passenger type is not correct.

Request

Body Params application/json

Example
{
    "authentication": {
        "sign": "{{sign}}",
        "partnerId": "{{partnerId}}"
    },
    "pricing": {
        "journeys": {
            "journey_0": [
                {
                    "departureTime": "14:40",
                    "flightNum": "501",
                    "arrival": "DMK",
                    "arrivalTime": "16:40",
                    "bookingCode": "Z",
                    "departure": "HKG",
                    "departureDate": "2024-12-15",
                    "airline": "FD",
                    "arrivalDate": "2024-12-15"
                }
            ],
            "journey_1": [
                {
                    "departureTime": "15:30",
                    "flightNum": "504",
                    "arrival": "HKG",
                    "arrivalTime": "17:15",
                    "bookingCode": "A",
                    "departure": "DMK",
                    "departureDate": "2024-12-30",
                    "airline": "FD",
                    "arrivalDate": "2024-12-30"
                }
            ]
        },
        "children": "0",
        "solutionId": "iXf1ufZoOsBU+MpHfwQD6vzfcE3X5BFe1Vxl3oa9iNn1Noc75XschKYpLVXfU17PcPI7oU/EVSKjQj2Xuxt9QoSJGTP7oW12BBtDUQvlAzaZ1z0zhjr4N5cJVh2fElsdEXXtCGI00H3Nvx98/d2z6lUfU0Yhuny0kj/rOz4IMMmghIhWyGDa4e4T7y3BrTjFwEPZh0nHoEykVO13sMp0vXt8ub60T12OXl9dooXkhpqN51MhNjyCkSYjIYff//DJ1cRBps9+3e58SI0ifR8P6FiCKSCYOmCQLFKKLU0P8+Xlv4BsqxNY0pdOKT7LeR3w2YGgt1zSCyEXZCwy/+BBLA66j01ytAzieUvdZ3sqLyc8+7IG23vo1JfqVtlJo/pvRdlQyp6gQGJDPraSkTCSvA==",
        "tag": "SAVER",
        "adults": "1",
        "ancillary": [
            1,
            2
        ]
    }
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.pkfare.com/json/ancillaryPricingV6' \
--header 'Content-Type: application/json' \
--data '{
    "authentication": {
        "sign": "",
        "partnerId": ""
    },
    "pricing": {
        "journeys": {
            "journey_0": [
                {
                    "departureTime": "14:40",
                    "flightNum": "501",
                    "arrival": "DMK",
                    "arrivalTime": "16:40",
                    "bookingCode": "Z",
                    "departure": "HKG",
                    "departureDate": "2024-12-15",
                    "airline": "FD",
                    "arrivalDate": "2024-12-15"
                }
            ],
            "journey_1": [
                {
                    "departureTime": "15:30",
                    "flightNum": "504",
                    "arrival": "HKG",
                    "arrivalTime": "17:15",
                    "bookingCode": "A",
                    "departure": "DMK",
                    "departureDate": "2024-12-30",
                    "airline": "FD",
                    "arrivalDate": "2024-12-30"
                }
            ]
        },
        "children": "0",
        "solutionId": "iXf1ufZoOsBU+MpHfwQD6vzfcE3X5BFe1Vxl3oa9iNn1Noc75XschKYpLVXfU17PcPI7oU/EVSKjQj2Xuxt9QoSJGTP7oW12BBtDUQvlAzaZ1z0zhjr4N5cJVh2fElsdEXXtCGI00H3Nvx98/d2z6lUfU0Yhuny0kj/rOz4IMMmghIhWyGDa4e4T7y3BrTjFwEPZh0nHoEykVO13sMp0vXt8ub60T12OXl9dooXkhpqN51MhNjyCkSYjIYff//DJ1cRBps9+3e58SI0ifR8P6FiCKSCYOmCQLFKKLU0P8+Xlv4BsqxNY0pdOKT7LeR3w2YGgt1zSCyEXZCwy/+BBLA66j01ytAzieUvdZ3sqLyc8+7IG23vo1JfqVtlJo/pvRdlQyp6gQGJDPraSkTCSvA==",
        "tag": "SAVER",
        "adults": "1",
        "ancillary": [
            1,
            2
        ]
    }
}'

Responses

🟢200Success
application/json
Bodyapplication/json

Examples
{
    "errorCode": "0",
    "errorMsg": "ok",
    "data": [
        {
            "ancillaryType": 1,
            "ancillary": {
                "journeys": [
                    {
                        "airline": "FD",
                        "flightNum": "504",
                        "departure": "DMK",
                        "departureDate": "2024-12-30",
                        "departureTime": "15:30",
                        "arrival": "HKG",
                        "arrivalDate": "2024-12-30",
                        "arrivalTime": "19:15",
                        "bookingCode": "A",
                        "cabinClass": "ECONOMY"
                    }
                ],
                "ancillaries": {
                    "baggage": [
                        {
                            "ancillaryKey": "58ef0820cfb6dee57c3f89e6d4600be4",
                            "ancillaryType": 1,
                            "payBaggageType": 1,
                            "baggagePiece": -1,
                            "baggageWeight": "20KG",
                            "baggageCurrency": "USD",
                            "baggagePrice": 28.300,
                            "description": ""
                        },
                        {
                            "ancillaryKey": "393fa6969e30a692c190ee2d303a59c8",
                            "ancillaryType": 1,
                            "payBaggageType": 1,
                            "baggagePiece": -1,
                            "baggageWeight": "25KG",
                            "baggageCurrency": "USD",
                            "baggagePrice": 35.610,
                            "description": ""
                        },
                        {
                            "ancillaryKey": "742bcb8b01e37144a5f109cf2643b8fe",
                            "ancillaryType": 1,
                            "payBaggageType": 1,
                            "baggagePiece": -1,
                            "baggageWeight": "40KG",
                            "baggageCurrency": "USD",
                            "baggagePrice": 81.580,
                            "description": "1 bag must not exceed 32 kg"
                        },
                        {
                            "ancillaryKey": "1129247874c431bfe6f967ad4a797ef7",
                            "ancillaryType": 1,
                            "payBaggageType": 1,
                            "baggagePiece": -1,
                            "baggageWeight": "50KG",
                            "baggageCurrency": "USD",
                            "baggagePrice": 105.470,
                            "description": "1 bag must not exceed 32 kg"
                        },
                        {
                            "ancillaryKey": "88b4c663ed4a75d578a50cbd9e737f0c",
                            "ancillaryType": 1,
                            "payBaggageType": 1,
                            "baggagePiece": -1,
                            "baggageWeight": "60KG",
                            "baggageCurrency": "USD",
                            "baggagePrice": 131.280,
                            "description": "1 bag must not exceed 32 kg"
                        }
                    ]
                }
            }
        },
        {
            "ancillaryType": 1,
            "ancillary": {
                "journeys": [
                    {
                        "airline": "FD",
                        "flightNum": "501",
                        "departure": "HKG",
                        "departureDate": "2024-12-15",
                        "departureTime": "14:40",
                        "arrival": "DMK",
                        "arrivalDate": "2024-12-15",
                        "arrivalTime": "16:40",
                        "bookingCode": "Z",
                        "cabinClass": "ECONOMY"
                    }
                ],
                "ancillaries": {
                    "baggage": [
                        {
                            "ancillaryKey": "907d145eaa761e8361bbd820d9bfb755",
                            "ancillaryType": 1,
                            "payBaggageType": 1,
                            "baggagePiece": -1,
                            "baggageWeight": "20KG",
                            "baggageCurrency": "USD",
                            "baggagePrice": 32.990,
                            "description": ""
                        },
                        {
                            "ancillaryKey": "0f2e71c6e3aa1d950d2012ac06146211",
                            "ancillaryType": 1,
                            "payBaggageType": 1,
                            "baggagePiece": -1,
                            "baggageWeight": "25KG",
                            "baggageCurrency": "USD",
                            "baggagePrice": 41.690,
                            "description": ""
                        },
                  
🟢200Error
Modified at 2026-08-20 08:41:08
Previous
AncillaryStatusPush
Next
AncillaryBooking