{
  "info": {
    "name": "Avunzo API · Visa",
    "description": "Visa requirements, applications and tracking.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "item": [
    {
      "name": "Booking flow",
      "item": [
        {
          "name": "Search for available visa packages",
          "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-visa/search",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "service-visa",
                "search"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"country_code\": \"TH\",\n  \"visa_category\": \"business-visa\",\n  \"guest_nationality\": \"BD\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Searches available visa services by destination country and visa category. Empty country_code and visa_category return all categories."
          },
          "response": []
        },
        {
          "name": "Get specific visa details by SEO code",
          "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-visa/details",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "service-visa",
                "details"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"visa_seo_code\": \"medical-visa\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Returns options, FAQ and country information for one visa category, identified by its SEO code."
          },
          "response": []
        },
        {
          "name": "Validate visa selection before booking",
          "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-visa/validation",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "service-visa",
                "validation"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"visa_seo_code\": \"test-category-visa\",\n  \"visa_option_code\": \"visit-visa\",\n  \"guest_nationality\": \"BD\",\n  \"guest_visite\": \"IQ\",\n  \"checkIn\": \"2027-03-10\",\n  \"total_adult\": 2,\n  \"total_child\": 0\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Validates visa availability, traveller eligibility and travel date for a selected visa option. Returns a tracking_id for the following steps."
          },
          "response": []
        },
        {
          "name": "Get validated visa details using tracking ID",
          "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-visa/validation-details",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "service-visa",
                "validation-details"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"tracking_id\": \"1177235201788128GTBLA\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Returns the validated visa selection and pricing for a tracking_id from the validation step."
          },
          "response": []
        },
        {
          "name": "Create a new visa application 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-visa/order",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "service-visa",
                "order"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"member_id\": \"1\",\n  \"tracking_id\": \"1177468979868881A2U8M\",\n  \"payment_type\": \"account_balance\",\n  \"redirect_url\": \"https://agent.test.lan/booking_details/\",\n  \"visa_applicant\": [\n    {\n      \"visa_option_code\": \"medical-visa\",\n      \"pax_id\": \"1\",\n      \"gender\": \"M\",\n      \"title\": \"Mr\",\n      \"first_name\": \"test\",\n      \"last_name\": \"Ali\",\n      \"dob\": \"1995-10-24\",\n      \"doc_country\": \"BD\",\n      \"doc_no\": \"ER1212121\",\n      \"doc_dateofexpiry\": \"2030-04-25\",\n      \"isd_code\": \"880\",\n      \"contact_no\": \"1966330000\",\n      \"email_address\": \"test@example.com\",\n      \"attachment\": [\n        {\n          \"name\": \"passport\",\n          \"url\": \"https://enterpise.s3.ap-southeast-1.amazonaws.com/profile_picture/profile_picture-1-3-1721194599-90880.jpg\"\n        },\n        {\n          \"name\": \"photo\",\n          \"url\": \"https://enterpise.s3.ap-southeast-1.amazonaws.com/profile_picture/profile_picture-1-3-1721194599-90880.jpg\"\n        }\n      ]\n    },\n    {\n      \"visa_option_code\": \"medical-visa\",\n      \"pax_id\": \"2\",\n      \"gender\": \"M\",\n      \"title\": \"Mr\",\n      \"first_name\": \"Mahade Hasan\",\n      \"last_name\": \"test\",\n      \"dob\": \"2001-07-11\",\n      \"doc_country\": \"BD\",\n      \"doc_no\": \"AE12525090\",\n      \"doc_dateofexpiry\": \"2030-01-25\",\n      \"isd_code\": \"880\",\n      \"contact_no\": \"1966330000\",\n      \"email_address\": \"mahadehasanbd00@gmail.com\",\n      \"attachment\": [\n        {\n          \"name\": \"passport\",\n          \"url\": \"https://hoteljson.Demoystem.com/testpdf/test_03_voucher_supplier.pdf\"\n        },\n        {\n          \"name\": \"photo\",\n          \"url\": \"https://enterpise.s3.ap-southeast-1.amazonaws.com/profile_picture/profile_picture-1-3-1721194599-90880.jpg\"\n        }\n      ]\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Submits applicant, passport and document details to create the visa order for one or more travellers."
          },
          "response": []
        }
      ]
    },
    {
      "name": "More endpoints",
      "item": [
        {
          "name": "List visa document types",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "apikey",
                "value": "{{apikey}}",
                "type": "text"
              },
              {
                "key": "secretecode",
                "value": "{{secretecode}}",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/service-visa/doc-type-suggestion",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "service-visa",
                "doc-type-suggestion"
              ]
            },
            "description": "Returns document type codes and titles used when uploading visa documents. The path spelling `doc-type-suggestion` is the real server path."
          },
          "response": []
        },
        {
          "name": "List visa countries",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "apikey",
                "value": "{{apikey}}",
                "type": "text"
              },
              {
                "key": "secretecode",
                "value": "{{secretecode}}",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/service-visa/country-suggetion",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "service-visa",
                "country-suggetion"
              ]
            },
            "description": "Returns countries that have visa services, for the search country picker. The path spelling `country-suggetion` is the real server path."
          },
          "response": []
        },
        {
          "name": "List visa categories",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "apikey",
                "value": "{{apikey}}",
                "type": "text"
              },
              {
                "key": "secretecode",
                "value": "{{secretecode}}",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/service-visa/category-suggetion",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "service-visa",
                "category-suggetion"
              ]
            },
            "description": "Returns visa categories for the search category picker. The path spelling `category-suggetion` is the real server path."
          },
          "response": []
        },
        {
          "name": "Update visa applicant 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-visa/order-info-update",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "service-visa",
                "order-info-update"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"member_id\": \"1\",\n  \"tracking_id\": \"111775111387888638XGGS\",\n  \"pax_id\": \"1\",\n  \"title\": \"MR\",\n  \"gender\": \"male\",\n  \"isd_code\": \"880\",\n  \"full_name\": \"Test Traveller\",\n  \"date_of_birth\": \"1990-01-01\",\n  \"passport\": \"X0000000\",\n  \"nationality\": \"BD\",\n  \"doc_dateofexpiry\": \"2030-01-01\",\n  \"email\": \"traveller@example.com\",\n  \"contact_no\": \"0000000000\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Updates one applicant's personal and passport details on an existing visa order. Observed in itt_b2b; semantics unconfirmed beyond the fields listed."
          },
          "response": []
        },
        {
          "name": "Upload a visa applicant document",
          "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-visa/order-document-update",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "service-visa",
                "order-document-update"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"member_id\": \"1\",\n  \"tracking_id\": \"111775111387888638XGGS\",\n  \"pax_id\": \"1\",\n  \"doc_for\": \"passport\",\n  \"file_url\": \"https://cdn.example.com/doc.jpg\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Attaches an uploaded document to one applicant on an existing visa order. The `file_url` is the `ObjectURL` returned by `/tools/upload-cdn`."
          },
          "response": []
        },
        {
          "name": "Cancel visa applicants",
          "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-visa/order-cancel",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "service-visa",
                "order-cancel"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"member_id\": \"1\",\n  \"tracking_id\": \"111775111387888638XGGS\",\n  \"pax_id\": \"all\",\n  \"reason\": \"Change of plan\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Cancels one applicant, or all applicants when `pax_id` is \"all\". itt_b2b sends one call per applicant when cancelling several. Observed in itt_b2b; semantics unconfirmed."
          },
          "response": []
        }
      ]
    }
  ],
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://serviceapi.avunzo.net"
    }
  ]
}