{
  "info": {
    "name": "Avunzo API · Tour package",
    "description": "Packaged holidays and itineraries.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "item": [
    {
      "name": "Booking flow",
      "item": [
        {
          "name": "Search tours",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "apikey",
                "value": "{{apikey}}",
                "type": "text"
              },
              {
                "key": "secretecode",
                "value": "{{secretecode}}",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/service-tour/search",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "service-tour",
                "search"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"country_code\": \"\",\n  \"city_code\": \"\",\n  \"tour_category_code\": \"\",\n  \"tour_name\": \"\",\n  \"tour_date\": \"2027-11-11\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Searches tours by country, city, category, tour name and date. Empty filters broaden the search. Results come back in `data[]` with `offers[]`."
          },
          "response": []
        },
        {
          "name": "Get tour details",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "apikey",
                "value": "{{apikey}}",
                "type": "text"
              },
              {
                "key": "secretecode",
                "value": "{{secretecode}}",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/service-tour/details",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "service-tour",
                "details"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"tour_seo_code\": \"dubai-3-nights-4-days-tour-package\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Returns full details of one tour using its SEO code."
          },
          "response": []
        },
        {
          "name": "Validate tour selection",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "apikey",
                "value": "{{apikey}}",
                "type": "text"
              },
              {
                "key": "secretecode",
                "value": "{{secretecode}}",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/service-tour/validate",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "service-tour",
                "validate"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"tour_seo_code\": \"dubai-3-nights-4-days-tour-package\",\n  \"adult\": \"2\",\n  \"child\": \"0\",\n  \"infant\": \"0\",\n  \"hotel_data\": [\n    \"290\"\n  ],\n  \"transfer_data\": [\n    \"349\"\n  ],\n  \"flight_data\": [\n    \"293\"\n  ],\n  \"insurance_data\": [\n    \"330\"\n  ],\n  \"activity_data\": [\n    \"294\"\n  ],\n  \"meal_data\": [\n    \"297\"\n  ],\n  \"guide\": [\n    \"331\"\n  ],\n  \"checkIn\": \"2027-10-31\",\n  \"extra_bed\": \"no\",\n  \"extra_bed_amount\": \"2\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Validates the chosen tour with its hotel, transfer, flight and add-on selections for a date and passenger count. Returns a tracking_id used by the following steps."
          },
          "response": []
        },
        {
          "name": "Get validation details",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "apikey",
                "value": "{{apikey}}",
                "type": "text"
              },
              {
                "key": "secretecode",
                "value": "{{secretecode}}",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/service-tour/validation-details",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "service-tour",
                "validation-details"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"tracking_id\": \"31177718803526194Z77UX\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Returns the priced summary of a validated tour for a tracking_id."
          },
          "response": []
        },
        {
          "name": "Update tour travellers",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "apikey",
                "value": "{{apikey}}",
                "type": "text"
              },
              {
                "key": "secretecode",
                "value": "{{secretecode}}",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/service-tour/update-traveller",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "service-tour",
                "update-traveller"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"tracking_id\": \"31177718803526194Z77UX\",\n  \"member_id\": \"1\",\n  \"save_pax\": \"no\",\n  \"passenger\": [\n    {\n      \"pax_id\": \"1\",\n      \"pax_type\": \"ADT\",\n      \"gender\": \"M\",\n      \"title\": \"Mr\",\n      \"first_name\": \"Mahade Hasan\",\n      \"last_name\": \"Ali\",\n      \"dob\": \"1993-10-24\",\n      \"isd_code\": \"880\",\n      \"contact_no\": \"1966330000\",\n      \"email_address\": \"test@test.com\"\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Saves passenger details against a validated tour tracking_id."
          },
          "response": []
        },
        {
          "name": "Create tour order",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "apikey",
                "value": "{{apikey}}",
                "type": "text"
              },
              {
                "key": "secretecode",
                "value": "{{secretecode}}",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/service-tour/order",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "service-tour",
                "order"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"tracking_id\": \"1176243236526194WVF8W\",\n  \"member_id\": \"1\",\n  \"isd_code\": \"880\",\n  \"contact_no\": \"1966330000\",\n  \"email_address\": \"test@example.com\",\n  \"special_requests_notes\": \"n/a\",\n  \"agency_isd_code\": \"880\",\n  \"agency_contact_no\": \"1966330000\",\n  \"agency_email\": \"test@example.com\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Confirms the tour booking. When payment_type is card, redirect_url is used for the payment gateway."
          },
          "response": []
        },
        {
          "name": "Issue tour order",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "apikey",
                "value": "{{apikey}}",
                "type": "text"
              },
              {
                "key": "secretecode",
                "value": "{{secretecode}}",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/service-tour/issue-order",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "service-tour",
                "issue-order"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"member_id\": \"1\",\n  \"tracking_id\": \"1175846471228195ILFOJ\",\n  \"price_change_accepted\": \"no\",\n  \"notes\": \"not required\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Issues the voucher for a tour order. A price change must be accepted explicitly with price_change_accepted. Not called by itt_b2b, to confirm with the backend team."
          },
          "response": []
        }
      ]
    },
    {
      "name": "More endpoints",
      "item": [
        {
          "name": "List tour countries",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "apikey",
                "value": "{{apikey}}",
                "type": "text"
              },
              {
                "key": "secretecode",
                "value": "{{secretecode}}",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/service-tour/country-suggetion",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "service-tour",
                "country-suggetion"
              ]
            },
            "description": "Returns countries that have tours, for the search country picker. The path spelling `country-suggetion` is the real server path."
          },
          "response": []
        },
        {
          "name": "List tour categories",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "apikey",
                "value": "{{apikey}}",
                "type": "text"
              },
              {
                "key": "secretecode",
                "value": "{{secretecode}}",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/service-tour/category-suggetion",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "service-tour",
                "category-suggetion"
              ]
            },
            "description": "Returns tour categories for the search category picker. The path spelling `category-suggetion` is the real server path."
          },
          "response": []
        },
        {
          "name": "List tour cities by country",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "apikey",
                "value": "{{apikey}}",
                "type": "text"
              },
              {
                "key": "secretecode",
                "value": "{{secretecode}}",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/service-tour/city-suggetion",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "service-tour",
                "city-suggetion"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"country_code\": \"\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Returns cities that have tours for a country code. An empty country_code returns cities for all countries. The path spelling `city-suggetion` is the real server path."
          },
          "response": []
        },
        {
          "name": "Get tour order details",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "apikey",
                "value": "{{apikey}}",
                "type": "text"
              },
              {
                "key": "secretecode",
                "value": "{{secretecode}}",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/service-tour/order-details",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "service-tour",
                "order-details"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"tracking_id\": \"1175160241551208JLFCS\",\n  \"booking_id\": \"NS2504JLC7AABY\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Returns status and summary of a confirmed tour order by tracking_id and booking_id. Not called by itt_b2b, to confirm with the backend team."
          },
          "response": []
        }
      ]
    }
  ],
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://serviceapi.avunzo.net"
    }
  ]
}