# 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)"
}
}
```
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://visadoc-co.gitbook.io/docs/quick-start/creating-an-assessment-api-request.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.