Check offer availability

POST

/checkOffer

Checks live availability and retrieves the most current price for one or more package offers. Send up to 10 offers from a previous sendMessage packagelist response, and the API verifies each against the supplier in parallel. Returns an availability status (AVAILABLE, NOT_AVAILABLE, or UNKNOWN) and a refreshed price per offer. Use this between search and booking to ensure offers are still sellable at an accurate price.

Request

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200Success

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.ygo.ai/v1/checkOffer' \
--header 'X-User-ID: user_abc123' \
--header 'Authorization: Bearer your_project_auth_token' \
--header 'Content-Type: application/json' \
--data '{
  "Locale": "de",
  "Offers": [
    {
      "OfferKey": "product-8962-0",
      "GiataID": 4569,
      "TravellerAges": [
        30,
        30
      ],
      "PackageOffer": {
        "TourOperator": {
          "name": "Dertour Hotel",
          "code": "DER"
        },
        "Accommodation": {
          "Name": "",
          "Rooms": [
            {
              "Description": "Doppelzimmer Standard",
              "PersonAssignments": [
                1,
                2
              ],
              "Types": [
                "ST04-DO"
              ],
              "Code": "DB3",
              "Key": "",
              "Attributes": [
                "FLX-C-P14D",
                "FLX-EXCL",
                "FLX-M-P14D",
                "FLX-OPT",
                "GT05-AICO#AT05-FRCH",
                "GT05-BALC",
                "GT05-BERO#AT05-N1",
                "GT05-COTT",
                "GT05-FLOO#ST05-LAFL",
                "GT05-HAIR",
                "GT05-MINI#AT05-EXCO",
                "GT05-NOSM",
                "GT05-SAFE#AT05-EXCO",
                "GT05-SHOW",
                "GT05-TELE#AT05-N1",
                "GT05-TELE#ST05-SATV",
                "GT05-TELE#ST05-SATV#AT05-N1",
                "GT05-TELP",
                "GT05-TOIL"
              ],
              "BookingCode": "DB3F",
              "MaxChildAge": 14,
              "PriceByUnit": false,
              "SoldOut": false,
              "Board": "bed and breakfast",
              "BoardTypes": [
                "GT06-BB"
              ],
              "BoardCode": "F",
              "BoardKey": "",
              "Extras": [
                {
                  "type": "GT07-SC"
                },
                {
                  "type": "GT08-ARDE#ST08-RAFL"
                }
              ]
            }
          ],
          "Code": "AYT19061N",
          "Key": "",
          "LengthOfStay": 3,
          "ArrivalDate": "2026-04-16",
          "Provider": "",
          "ProgramType": "DPS",
          "SoldOut": false,
          "NearestAirportDLC": "AYT",
          "NearestAirportCity": "",
          "NearestAirportName": "Antalya Airport"
        },
        "Transport": {
          "departure": {
            "transportType": "FLIGHT",
            "departureAirport": {
              "name": "Berlin",
              "code": "BER"
            },
            "arrivalAirport": {
              "name": "Antalya",
              "code": "AYT"
            },
            "airline": {
              "name": "Pegasus Airlines",
              "code": "PC"
            },
            "Price": {
              "Amount": 239.08,
              "Currency": ""
            },
            "flightSegments": [
              {
                "departureAirport": {
                  "name": "Berlin",
                  "code": "BER"
                },
                "arrivalAirport": {
                  "name": "Antalya",
                  "code": "AYT"
                },
                "departureDateTime": "2026-04-16T18:50:00+02:00",
                "arrivalDateTime": "2026-04-16T23:05:00+03:00",
                "flightNumber": "PC5008",
                "bookingClass": "Y",
                "operatingCarrier": "PC",
                "duration": 195,
                "airline": {
                  "name": "Pegasus Airlines",
                  "code": "PC"
                },
                "flightClass": "ECONOMY"
              }
            ],
            "luggageAllowance": {
              "handLuggageAmount": 1,
              "handLuggageWeight": 8,
              "checkedLuggageAmount": 0,
              "checkedLuggageWeight": 0
            },
            "departureDateTime": "2026-04-16T18:50:00+02:00",
            "arrivalDateTime": "2026-04-16T23:05:00+03:00",
            "flightId": "",
            "flightCode": "BERAYTMPC0U41C1B_X0",
            "flightNumber": "5008",
            "flightKey": "BERAYTPCCBEM40U41YC1B",
            "bookingClass": "Y",
            "bookingCode": "F",
            "flightClass": "ECONOMY",
            "localSupplier": "",
            "distance": 2204,
            "duration": 195,
            "priority": 0,
            "stopOver": 0,
            "provider": "ASG",
            "soldOut": false,
            "additionalLink": "",
            "checkInUrl": ""
          },
          "return": {
            "transportType": "FLIGHT",
            "departureAirport": {
              "name": "Antalya",
              "code": "AYT"
            },
            "arrivalAirport": {
              "name": "Berlin",
              "code": "BER"
            },
            "airline": {
              "name": "Mavi Gok Airlines",
              "code": "4M"
            },
            "Price": {
              "Amount": 184.62,

Response Example

{
    "Data": {
        "Results": [
            {
                "OfferKey": "cart-item-1",
                "Status": "AVAILABLE",
                "SubStatus": "",
                "Price": 1299.50,
                "Currency": "EUR",
                "Reason": "",
                "Error": ""
            }
        ]
    },
    "Error": null
}

Modified at 2026-04-14 10:45:30

Get or create open booking

Update open booking