PrecisePricing V11

Function

Through PrecisePricing API, the precise price will be shown with specific flight details, including booking code and seat availability. If specific cabin class is requested (cabin class should be specified in all segments), the lowest fare corresponding to the specified class will be shown.

PrecisePricing service is able to check flight price based on cabin class. We will respond the real-time price and availability.

Versioning

Version	Sandbox Invoking Address	Update
PrecisePricing	https://api.pkfare.com/precisePricing
PrecisePricing_V2	https://api.pkfare.com/precisePricing_V2	Add baggageMap and miniRuleMap, only for reference. Offer BookingWithoutCard notification in response.
PrecisePricing_V4	https://api.pkfare.com/precisePricing_V4	Support infant (no seat) .
PrecisePricing_V5	https://api.pkfare.com/precisePricing_V5	Add Ancillary flag to indicate which ancillary service is available
PrecisePricing_V6	https://api.pkfare.com/precisePricing_V6	Add solutionId to enhance tracebility and data visibility
PrecisePricing_V6(json foramt)	https://api.pkfare.com/json/precisePricing_V6	Add solutionId to enhance tracebility and data visibility;Support json formatted requesting structure
PrecisePricing_V9(json foramt)	https://api.pkfare.com/json/precisePricing_V9	Support pricing virtual interlining content
PrecisePricing_V10(json foramt)	https://api.pkfare.com/json/precisePricing_V10	Support pricing different product tags, including PKFARE-defined special product types and airline-standard branded fares, etc.
PrecisePricing_V11(json foramt)	https://api.pkfare.com/json/precisePricing_V11	Support more precise structrued fare rules [miniRules] with time tiers

*Below is the most updated version"

Error Code List

erroCode	erroMsg	Description
0	ok	Request has been processed successfully.
S001	System error.	System error.
B002	Partner does not exists.	PartnerID does not exist.
B003	Illegal sign.	Illegal sign. Please check your signature.
B035	Concurrency limited. Please contact PKFARE API support team for assistant.	Concurrency exceeded system limits.
P001	XXX is illegal.	The field of XXX is illegal.
P002	XXX is missing.	The field of XXX is missing.
P004	The maximum number of passengers with seat is 9.	Wrong parameter. The maximum number of passengers with seat is 9.
P005	There should be at least one adult.	Wrong parameter. There should be at least one adult.
P009	The number of infant passengers can not exceed the number of adult passengers.	Wrong parameter. The number of infant passengers can not exceed the number of adult passengers.
B013	Interface is limited, please contact the system administrator.	The route that you request is limited, please contact system administrator.
B015	Pricing failed.	Pricing failed for other reason.
B016	Flight near take-off, can’t offer pricing service.	Pricing fail. Can not pricing for flights that is near taking off.
B018	Airline or flight restriction.	Airline or flight restriction.
B019	Can not find any supplier for current search.	Can not find any supplier for current search.
B020	Can not find any price for this flight.	Pricing fail. Can not find any price for this flight option.
B021	The booking code you choose has only 0 seat available.	Pricing fail. The booking code you choose has 0 seat left. Please choose other booking code or flight.
B026	LatestTktTime: yyyy-mm-dd hh : mm: ss.	Last ticketing time is not enough to issue ticket.
B024	Pricing TimeOut.	Pricing TimeOut.
B035	Concurrency limited. Please contact PKFARE API support team for assistant.	Concurrent users control. Please contact PKFARE API support for assistant.
B039	Can't find the related data of XXX.	Wrong parameter. Can't find the related data of XXX, like illegal city/country/area/airline.
B046	Interface is limited, the routing is offlined by PKFARE.	Look to book control. If you need this routing, please contact PKFARE API for assistant.
B068	The segment detail is different between solutionid field and journey field.	Please verify whether the information in the pricing request matches the details from the shopping response.
B121	Supplier is offline	Supplier is not at working time, please contact PKFARE API support.

application/json

Bodyapplication/json

Examples

Success(One Way Journey)Success(Round Trip Journey)Success(One Way Journey VI)Success(One Way Journey Fare Family)Success(Round Trip Journey Fare Family)Success with time-tiered fare rules

{
    "errorCode": "0",
    "errorMsg": "ok",
    "data": {
        "solution": {
            "solutionKey": "cadce3d7a693476e02a0e841d586fbcb",
            "solutionId": "DMHkxtUMupBvCYeSAZKvI2XPSDdKRK2kK27eMKAEE+F2gdW8n4ZhopICv6eJNS40zcS8otwiL7wFzPBaAV7LVv2D95+F/d+5de4BWOJA5bK31lUgTmtnRxndjrSZ1zzN3Mi6x5gpdI9FeWUc7EQnsceDYXG39qudoyIneDp4SIXpUF8vpposuSdigXFrVDzpymiC438EKaAZir9UEp4DEeLyOjTCo1/PvTyURv9tRMj53bdg+S694JVZycYIq04SQ7mk2NfOZ1rVVHcNgSHvDAORkJ2rv/U9ZjzI5sLdcyS7zdu/MyOpCt3KHXet6Onr",
            "fareType": "PRIVATE",
            "currency": "USD",
            "adtFare": 25.69,
            "adtTax": 59.39,
            "chdFare": 0,
            "chdTax": 0,
            "tktFee": 0,
            "platformServiceFee": 0,
            "journeys": {
                "journey_0": [
                    "07177e6e653830b4b2e151f215c8fd19"
                ]
            },
            "platingCarrier": "VJ",
            "merchantFee": 0,
            "adults": 1,
            "children": 0,
            "infants": 0,
            "baggages": {
                "1": {
                    "carryOn": "1PC7KG",
                    "baggage": "0PC"
                },
                "2": {
                    "carryOn": "1PC7KG",
                    "baggage": "0PC"
                }
            },
            "baggageMap": {
                "ADT": [
                    {
                        "segmentIndexList": [
                            1,
                            2
                        ],
                        "baggageAmount": "0PC",
                        "carryOnAmount": "1PC",
                        "carryOnWeight": "7KG"
                    }
                ]
            },
            "miniRuleMap": {
                "ADT": [
                    {
                        "segmentIndex": [
                            1,
                            2
                        ],
                        "miniRules": [
                            {
                                "penaltyType": 0,
                                "isPermited": 0,
                                "when": 0
                            },
                            {
                                "penaltyType": 1,
                                "isPermited": 0,
                                "when": 0,
                                "noShowTime": "0",
                                "noShowTimeUnit": "H"
                            },
                            {
                                "penaltyType": 2,
                                "isPermited": 0,
                                "when": 0
                            },
                            {
                                "penaltyType": 3,
                                "isPermited": 0,
                                "when": 0,
                                "noShowTime": "0",
                                "noShowTimeUnit": "H"
                            }
                        ]
                    }
                ]
            },
            "bookingWithoutCard": 1
        },
        "flights": [
            {
                "flightId": "07177e6e653830b4b2e151f215c8fd19",
                "journeyTime": 265,
                "transferCount": 0,
                "segmentIds": [
                    "5b6e4e840bb3321ca4ca21c422c99af6",
                    "7292bd918a99e91c03bb3323c22d99"
                ]
            }
        ],
        "segments": [
            {
                "segmentId": "5b6e4e840bb3321ca4ca21c422c99af6",
                "airline": "VJ",
                "flightNum": "503",
                "equipment": "32S",
                "cabinClass": "ECONOMY",
                "bookingCode": "K",
                "availabilityCount": 4,
                "departure": "HKG",
                "arrival": "SGN",
                "departureTerminal": "1",
                "arrivalTerminal": "2",
                "departureDate": 1734272400000,
                "arrivalDate": 1734279600000,
                "flightTime": 180,
                "stayTime": null,
                "codeShare": "N",
                "opFltNo": null,
                "opFltAirline": null,
                "stopover": null,
                "fareBasis": "YOW",
                "strDepartureDate": "2024-12-15",
                "strDepartureTime": "22:20",
                "strArrivalDate": "2024-12-16",
                "strArrivalTime": "00:20"
            },
            {
                "segmentId": "7292bd918a99e91c03bb3323c22d99",
                "airline": "FD",
                "flightNum": "665",
                "equipment": "A320",
                "cabinClass": "ECONOMY",
                "bookingCode": "J",
                "availabilityCount": 6,
                "departure": "SGN",
                "arrival": "DMK",
                "departureTerminal": "1",
                "arrivalTerminal": "2",
                "departureDate": 1734287400000,
                "arrivalDate": 1734291900000,
                "flightTime": 75,
                "stayTime": null,
                "codeShare": "N",
                "opFltNo": null,
                "opFltAirline": null,
                "stopover": null,
                "fareBasis": "YOW",
                "strDepartureDate": "2024-12-16",
                "strDepartureTime": "02:30",
                "strArrivalDate": "2024-12-16",
                "strArrivalTime": "03:45"
            }
        ],
        "ancillaryAvailability": {
            "paidBag": false,
            "paidSeat": false
        }
    }
}

Function

Versioning

Error Code List

Request

Request Code Samples

Responses

PrecisePricing V11

Function#

Versioning#

Error Code List#

Request

Request Code Samples

Responses

Function

Versioning

Error Code List