Verify - HK Ramble

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 TSYFare 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 TSYFare API support team for assistant. Concurrent users control. Please contact TSYFare 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 TSYFare. Look to book control. If you need this routing, please contact TSYFare 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 TSYFare API support.

Request

Body Params application/json

authentication

object (Authentication)

optional

partnerId

string

optional

partnerId

Example:

y1hYW6AQv4QcCs95wsuMNSzHwc

sign

string

optional

sign

Example:

0d83b8d315788029b979d10b67192b3

pricing

object (Pricing)

required

journeys

object (MapListAgodaJourney)

required

journey_0 outboundtrip, journey_1 inbound trip,

adults

integer

required

Number of adult passenger

Example:

children

integer

required

Number of child[age 2-12/14] passenger

Example:

infants

integer

required

Number of infant [age 0-2, no seat] passenger

Example:

cabin

string

optional

Cabin class ["" - the lowest cabin, Y - Economy, W - PremiumEconomy, C - business class, F - first class] if both 'cabin' and 'bookingCode' is valued and not inconsistent, precisePricing service would base on 'bookingCode'.

Example:

solutionId

string

required

Unique identification of each solution from Shopping API, request with it for associating with the Shopping solution and linking to the entire request process. In the case of a pricing failure, please retry using direct pricing by filling in this parameter to trigger the direct pricing mechanism.

Example:

solution123

Example

{
  "authentication": {
    "partnerId": "11111111111111",
    "sign": "222222222222222"
  },
  "pricing": {
    "adults": 2,
    "cabin": "Y",
    "children": 0,
    "journeys": {
      "journey_0": [
        {
          "airline": "VJ",
          "arrival": "SGN",
          "arrivalDate": "2025-05-23",
          "arrivalTime": "06:10",
          "bookingCode": "U",
          "departure": "TYO",
          "departureDate": "2025-05-23",
          "departureTime": "02:00",
          "flightNum": "VJ821",
          "segmentKey": "33b84e103ed240cb9d5a77115078d0e0"
        },
        {
          "airline": "VJ",
          "arrival": "DAD",
          "arrivalDate": "2025-05-23",
          "arrivalTime": "15:55",
          "bookingCode": "U",
          "departure": "SGN",
          "departureDate": "2025-05-23",
          "departureTime": "14:35",
          "flightNum": "VJ630",
          "segmentKey": "267ec1a5b4594140b658d259b88ae314"
        }
      ]
    },
    "solutionId": "7211c63e30d9495b83b13b004605ee31|^_FHpev7qdqeCQD9Vom+CfiAvC35g/9A8fuBYQGzW2iRQR7Rgjw3GF+MvHpIE/ZEFdHdq/pSmVryAm5sHP9lZzCNKWzGTB7vuOLdqixjqrBuXjIXKgyUsccMCAGH/0SvB0KD6i+w04JXpL/JVRWGXSe7tc+3aYi1Jo3k7mqJRznH88hD1Rnd5VrpxgGPy11MG3IqXRgv+StR6nh3Px+VizmIt+Ogm5yUAtbUgnaTdH2gIuVzuPG5X4hhEsI7HKe9q3YGEBZaaBSi2xBZ6dwnOnz8RPAjVZzHUjvjoJ3ixVYDoE4y8zc4aSh7v4Dlx7Ztz8y1Yknryy4E5DvOPT8ikTtIgYElIpoJ/xmtTsjKgvh/Svp/pAcZ3M5GdxEcrcYQXfmObi+I8q2g8gdCgOPXBQRzi76a+NU9knwj/aJTxhn5nCzYNYS3iBCCtlVRYOy+qnub3lJCZZnFEsSvNXaVRMqFDYkd/D/WfUv8zFnlPab+QZzpWMTMUtFUEfOKWPcB4giGQToD0Q2pqyuQqsRIMkpJ2G3KItnyrcsUgzGi5SExo="
  }
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/json/verify' \
--header 'Content-Type: application/json' \
--data-raw '{
    "authentication": {
        "partnerId": "11111111111111",
        "sign": "222222222222222"
    },
    "pricing": {
        "adults": 2,
        "cabin": "Y",
        "children": 0,
        "journeys": {
            "journey_0": [
                {
                    "airline": "VJ",
                    "arrival": "SGN",
                    "arrivalDate": "2025-05-23",
                    "arrivalTime": "06:10",
                    "bookingCode": "U",
                    "departure": "TYO",
                    "departureDate": "2025-05-23",
                    "departureTime": "02:00",
                    "flightNum": "VJ821",
                    "segmentKey": "33b84e103ed240cb9d5a77115078d0e0"
                },
                {
                    "airline": "VJ",
                    "arrival": "DAD",
                    "arrivalDate": "2025-05-23",
                    "arrivalTime": "15:55",
                    "bookingCode": "U",
                    "departure": "SGN",
                    "departureDate": "2025-05-23",
                    "departureTime": "14:35",
                    "flightNum": "VJ630",
                    "segmentKey": "267ec1a5b4594140b658d259b88ae314"
                }
            ]
        },
        "solutionId": "7211c63e30d9495b83b13b004605ee31|^_FHpev7qdqeCQD9Vom+CfiAvC35g/9A8fuBYQGzW2iRQR7Rgjw3GF+MvHpIE/ZEFdHdq/pSmVryAm5sHP9lZzCNKWzGTB7vuOLdqixjqrBuXjIXKgyUsccMCAGH/0SvB0KD6i+w04JXpL/JVRWGXSe7tc+3aYi1Jo3k7mqJRznH88hD1Rnd5VrpxgGPy11MG3IqXRgv+StR6nh3Px+VizmIt+Ogm5yUAtbUgnaTdH2gIuVzuPG5X4hhEsI7HKe9q3YGEBZaaBSi2xBZ6dwnOnz8RPAjVZzHUjvjoJ3ixVYDoE4y8zc4aSh7v4Dlx7Ztz8y1Yknryy4E5DvOPT8ikTtIgYElIpoJ/xmtTsjKgvh/Svp/pAcZ3M5GdxEcrcYQXfmObi+I8q2g8gdCgOPXBQRzi76a+NU9knwj/aJTxhn5nCzYNYS3iBCCtlVRYOy+qnub3lJCZZnFEsSvNXaVRMqFDYkd/D/WfUv8zFnlPab+QZzpWMTMUtFUEfOKWPcB4giGQToD0Q2pqyuQqsRIMkpJ2G3KItnyrcsUgzGi5SExo="
    }
}'

Responses

🟢200Success

application/json

Body

java.lang.Object

errorCode

string

required

Example:

errorMsg

string

required

Example:

data

object (PrecisePricingResp)

optional

java.lang.Object

shoppingKey

string

optional

solutions

array[object (Solution) {26}]

optional

flights

array[object (Flight) {5}]

optional

segments

array[object (Segment) {24}]

optional

Examples

Success成功示例

{
  "errorCode": "0",
  "errorMsg": "成功",
  "data": {
    "searchKey": null,
    "shoppingKey": "e7d6330bf9aa41779ded2843fd50838d",
    "solutions": [
      {
        "solutionKey": "N3a2IbJFNrUnbuInY3uAraue_v",
        "solutionId": "e7d6330bf9aa41779ded2843fd50838d|N3a2IbJFNrUnbuInY3uAraue_v",
        "fareType": "PRIVATE",
        "currency": "USD",
        "adtFare": 61.17,
        "adtTax": 48.29,
        "chdFare": 59.06,
        "chdTax": 48.29,
        "infFare": 0,
        "infTax": 0,
        "tktFee": 0,
        "platformServiceFee": 0,
        "comments": null,
        "journeys": {
          "journey_0": [
            "04647c0cc9444a8e8554d9c90ada673d"
          ]
        },
        "fareRule": null,
        "rule": null,
        "platingCarrier": "BX",
        "prices": null,
        "merchantFee": 0,
        "adults": 1,
        "children": 0,
        "infants": 0,
        "baggageMap": {
          "ADT": [
            {
              "segmentIndexList": [
                1
              ],
              "baggageAmount": "1",
              "baggageWeight": "15",
              "carryOnAmount": "1",
              "carryOnWeight": "10",
              "carryOnSize": null
            }
          ]
        },
        "miniRuleMap": {
          "ADT": {
            "segmentIndex": [
              1
            ],
            "miniRules": [
              {
                "penaltyType": 2,
                "isPermited": 0,
                "when": 0,
                "noShowTime": null,
                "noShowTimeUnit": null,
                "amount": null,
                "currencyCode": null,
                "percent": null,
                "baseType": null,
                "originAmount": null,
                "miniRuleAdjustAmount": null,
                "miniRuleAdjustFlag": null,
                "originCurrencyCode": null,
                "guarantee": null
              },
              {
                "penaltyType": 2,
                "isPermited": 0,
                "when": 1,
                "noShowTime": null,
                "noShowTimeUnit": null,
                "amount": null,
                "currencyCode": null,
                "percent": null,
                "baseType": null,
                "originAmount": null,
                "miniRuleAdjustAmount": null,
                "miniRuleAdjustFlag": null,
                "originCurrencyCode": null,
                "guarantee": null
              },
              {
                "penaltyType": 0,
                "isPermited": 0,
                "when": 0,
                "noShowTime": null,
                "noShowTimeUnit": null,
                "amount": null,
                "currencyCode": null,
                "percent": null,
                "baseType": null,
                "originAmount": null,
                "miniRuleAdjustAmount": null,
                "miniRuleAdjustFlag": null,
                "originCurrencyCode": null,
                "guarantee": null
              },
              {
                "penaltyType": 0,
                "isPermited": 0,
                "when": 1,
                "noShowTime": null,
                "noShowTimeUnit": null,
                "amount": null,
                "currencyCode": null,
                "percent": null,
                "baseType": null,
                "originAmount": null,
                "miniRuleAdjustAmount": null,
                "miniRuleAdjustFlag": null,
                "originCurrencyCode": null,
                "guarantee": null
              }
            ]
          },
          "CHD": {
            "segmentIndex": [
              1
            ],
            "miniRules": [
              {
                "penaltyType": 2,
                "isPermited": 0,
                "when": 0,
                "noShowTime": null,
                "noShowTimeUnit": null,
                "amount": null,
                "currencyCode": null,
                "percent": null,
                "baseType": null,
                "originAmount": null,
                "miniRuleAdjustAmount": null,
                "miniRuleAdjustFlag": null,
                "originCurrencyCode": null,
                "guarantee": null
              },
              {
                "penaltyType": 2,
                "isPermited": 0,
                "when": 1,
                "noShowTime": null,
                "noShowTimeUnit": null,
                "amount": null,
                "currencyCode": null,
                "percent": null,
                "baseType": null,
                "originAmount": null,
                "miniRuleAdjustAmount": null,
                "miniRuleAdjustFlag": null,
                "originCurrencyCode": null,
                "guarantee": null
              },
              {
                "penaltyType": 0,
                "isPermited": 0,
                "when": 0,
                "noShowTime": null,
                "noShowTimeUnit": null,
                "amount": null,
                "currencyCode": null,
                "percent": null,
                "baseType": null,
                "originAmount": null,
                "miniRuleAdjustAmount": null,
                "miniRuleAdjustFlag": null,
                "originCurrencyCode": null,
                "guarantee": null
              },
              {
                "penaltyType": 0,
                "isPermited": 0,
                "when": 1,
                "noShowTime": null,
                "noShowTimeUnit": null,
                "amount": null,
                "currencyCode": null,
                "percent": null,
                "baseType": null,
                "originAmount": null,
                "miniRuleAdjustAmount": null,
                "miniRuleAdjustFlag": null,
                "originCurrencyCode": null,
                "guarantee": null
              }
            ]
          }
        },
        "afterSaleRule": null,
        "qcharge": 0
      }
    ],
    "flights": [
      {
        "flightId": "04647c0cc9444a8e8554d9c90ada673d",
        "journeyTime": 405,
        "transferCount": 0,
        "lastTktTime": null,
        "segmengtIds": [
          "2df08db36c1246598b80afb0aaaf190d"
        ]
      }
    ],
    "segments": [
      {
        "segmentId": "2df08db36c1246598b80afb0aaaf190d",
        "airline": "BX",
        "flightNum": "0747",
        "equipment": "A321",
        "cabinClass": "Economy",
        "bookingCode": "L",
        "availabilityCount": 1,
        "departure": "ICN",
        "arrival": "BKK",
        "departureTerminal": null,
        "arrivalTerminal": null,
        "departureDate": 1748510100000,
        "arrivalDate": 1748524800000,
        "flightTime": 405,
        "stayTime": null,
        "codeShare": null,
        "opFltNo": null,
        "opFltAirline": null,
        "stopover": null,
        "fareBasis": null,
        "strDepartureDate": "2025-05-29",
        "strDepartureTime": "17:15",
        "strArrivalDate": "2025-05-29",
        "strArrivalTime": "21:20"
      }
    ]
  }
}