Creating an Assessment API Request

To create a new assessment, make an authorised API call to the Create Assessment endpoint with the following parameters:

​{​
  "location": "Applicant current location. Country ISO3 code",
  "residency": "Applicant current residency. Country ISO3 code",
  "destination": "Applicant travel destination. Country ISO3 code",
  "nationality": "Applicant current nationality. Country ISO3 code",
  "return_date": "Applicant return date in format 'YYYY-MM-DD'",
  "departure_date": "Applicant departure date in format 'YYYY-MM-DD'",
  "number_of_entries": "Multiple or Single number of entries",
  "requested_activity": "Applicant requested activities"​
​}

if the response was successful, you should get the following JSON:

Example response

[
  {
    "id": 543,
    "created_at": 1755182769726,
    "destination": "JPN",
    "residency": "USA",
    "nationality": "IND",
    "location": "USA",
    "departure_date": "2025-09-15",
    "return_date": "2025-09-22",
    "number_of_entries": "Single",
    "requested_activity": "Quarterly board meeting with Tokyo office",
    "result": {
      "entry_options": [
        {
          "max_stay_valid": true,
          "processing_time_valid": true,
          "entry_option_priority": "primary",
          "issues": [],
          "entry_option_details": {
            "id": 246,
            "visa_title": "Short-Term Stay Visa (for Business Affairs, etc.) - Single Entry",
            "business_activities": "Business contacts,Business negotiations,Participation in academic conferences,Market research,Contract signing,After-sales service",
            "visa_type": "Paper",
            "visa_validity_code": "3M",
            "visa_validity": "3 months",
            "visa_validity_days": 90,
            "max_length_of_stay_days": 90,
            "max_length_of_stay": "15, 30, or 90 days",
            "application_fee_value": 20,
            "application_fee_currency": "USD",
            "application_fee": "$20",
            "procesing_time_days": 5,
            "processing_time": "approximately one week",
            "destination": "JPN"
          },
          "entry_option_score": 1
        },
        {
          "max_stay_valid": true,
          "processing_time_valid": true,
          "entry_option_priority": "secondary",
          "issues": [],
          "entry_option_details": {
            "id": 248,
            "visa_title": "Short-Term Stay Visa (for Business Affairs, etc.) - Multiple Entry",
            "business_activities": "Business contacts,Business negotiations,Participation in academic conferences,Market research,Contract signing,After-sales service",
            "visa_type": "Paper",
            "visa_validity_code": "6M",
            "visa_validity": "6 months",
            "visa_validity_days": 180,
            "max_length_of_stay_days": 90,
            "max_length_of_stay": "up to 90 days",
            "application_fee_value": 40,
            "application_fee_currency": "USD",
            "application_fee": "$40",
            "procesing_time_days": 5,
            "processing_time": "at least 5 business days",
            "destination": "JPN"
          },
          "entry_option_score": 1
        }
      ],
      "visa_required": true,
      "notes": "Visa is Required",
      "visa_research_status": "ok",
      "categorized_visit_purposes": [
        "Attending technical/business meetings"
      ]
    }
  }
]

Explanation

{
  "id": "Unique identifier for this visa application (number)",
  "created_at": "Timestamp when application was created - Unix timestamp in milliseconds (number)",
  "destination": "Country code for Japan - destination country (string)",
  "residency": "Country where applicant currently resides (string)",
  "nationality": "Applicant's nationality - Indian citizen (string)",
  "location": "Current location of applicant (string)",
  "departure_date": "When applicant plans to leave for Japan (string)",
  "return_date": "When applicant plans to return - 7-day trip (string)",
  "number_of_entries": "Single entry visa requested (string)",
  "requested_activity": "Purpose of visit (string)",
  "result": {
    "entry_options": [
      {
        "max_stay_valid": "Trip duration fits within visa's maximum stay allowance (boolean)",
        "processing_time_valid": "Sufficient time for visa processing before departure (boolean)",
        "entry_option_priority": "This is the main/best visa option (string)",
        "issues": "problems identified with this visa option (array)",
        "entry_option_details": {
          "id": "Unique identifier for this visa type (number)",
          "visa_title": "Official visa name (string)",
          "business_activities": "Lists allowed activities - business contacts, negotiations, conferences, etc. (string)",
          "visa_type": "Peper, Electronic, Visa On Arrival,ETA/ESTA (string)",
          "visa_validity_code": "Code representing visa validity period (string)",
          "visa_validity": "How long the visa remains valid for entry (string)",
          "visa_validity_days": "Visa validity period in days (number)",
          "max_length_of_stay_days": "Maximum stay duration in days (number)",
          "max_length_of_stay": " Maximum stay duration  for stay (string)",
          "application_fee_value": "Numeric value of application fee (number)",
          "application_fee_currency": "Currency for the application fee (string)",
          "application_fee": "Cost to apply for this visa (string)",
          "procesing_time_days": "Processing time in days (number)",
          "processing_time": "Time needed to process application (string)",
          "destination": "Destination country code (string)"
        },
        "entry_option_score": "Rating score for this visa option (number)"
      }
    ],
    "visa_required": "Visa is mandatory for this trip (boolean)",
    "notes": "Summary note about visa requirement (string)",
    "visa_research_status": "Ok or Additional research required",
    "categorized_visit_purposes": "Lists the classified reasons for travel - business meetings, director functions (array)"
  }
}