> For the complete documentation index, see [llms.txt](https://api-docs.visadoc.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://api-docs.visadoc.co/api-reference/assessments.md).
# Assessments
## Check whether a traveller needs a visa or ETA for a trip, and which entry options work — the first step of every trip.
> Check whether a traveller needs a visa or ETA for a trip, and which entry options work — the first step of every trip.\
> \
\
\
> \Authentication:\ required
```json
{"openapi":"3.0.0","info":{"title":"v3","version":"0.0.1"},"servers":[{"url":"https://api.visadoc.co/api:v3"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}}},"paths":{"/assessments/new":{"post":{"operationId":"v3/assessments/new|POST","summary":"Check whether a traveller needs a visa or ETA for a trip, and which entry options work — the first step of every trip.","description":"Check whether a traveller needs a visa or ETA for a trip, and which entry options work — the first step of every trip.\n
\nAuthentication: required","tags":["assessments"],"parameters":[],"responses":{"200":{"description":"Success!","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer","format":"int64","description":"","default":543},"result":{"type":"object","properties":{"notes":{"type":"string","description":"","default":"Visa is Required"},"entry_options":{"type":"array","items":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"string","description":""},"default":"[]"},"max_stay_valid":{"type":"boolean","description":"","default":1},"entry_option_score":{"type":"integer","format":"int64","description":"","default":1},"entry_option_details":{"type":"object","properties":{"id":{"type":"integer","format":"int64","description":"","default":246},"visa_type":{"type":"string","description":"","default":"Paper"},"visa_title":{"type":"string","description":"","default":"Short-Term Stay Visa (for Business Affairs, etc.) - Single Entry"},"destination":{"type":"string","description":"","default":"JPN"},"visa_validity":{"type":"string","description":"","default":"3 months"},"application_fee":{"type":"string","description":"","default":"$20"},"processing_time":{"type":"string","description":"","default":"approximately one week"},"max_length_of_stay":{"type":"string","description":"","default":"15, 30, or 90 days"},"visa_validity_code":{"type":"string","description":"","default":"3M"},"visa_validity_days":{"type":"integer","format":"int64","description":"","default":90},"business_activities":{"type":"string","description":"","default":"Business contacts,Business negotiations,Participation in academic conferences,Market research,Contract signing,After-sales service"},"procesing_time_days":{"type":"integer","format":"int64","description":"","default":5},"application_fee_value":{"type":"integer","format":"int64","description":"","default":20},"max_length_of_stay_days":{"type":"integer","format":"int64","description":"","default":90},"application_fee_currency":{"type":"string","description":"","default":"USD"}}},"entry_option_priority":{"type":"string","description":"","default":"primary"},"processing_time_valid":{"type":"boolean","description":"","default":1}}}},"visa_required":{"type":"boolean","description":"","default":1},"visa_research_status":{"type":"string","description":"","default":"ok"},"categorized_visit_purposes":{"type":"array","items":{"type":"string","description":""},"default":"[\"Attending technical\\/business meetings\"]"}}},"location":{"type":"string","description":"","default":"USA"},"residency":{"type":"string","description":"","default":"USA"},"created_at":{"type":"integer","format":"int64","description":"","default":1755182769726},"destination":{"type":"string","description":"","default":"JPN"},"nationality":{"type":"string","description":"","default":"IND"},"return_date":{"type":"string","description":"","default":"2025-09-22"},"departure_date":{"type":"string","description":"","default":"2025-09-15"},"number_of_entries":{"type":"string","description":"","default":"Single"},"requested_activity":{"type":"string","description":"","default":"Quarterly board meeting with Tokyo office"}}}}}}},"400":{"description":"Input Error. Check the request payload for issues."},"401":{"description":"Unauthorized"},"403":{"description":"Access denied. Additional privileges are needed access the requested resource."},"404":{"description":"Not Found. The requested resource does not exist."},"429":{"description":"Rate Limited. Too many requests."},"500":{"description":"Unexpected error"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"destination":{"type":"string","description":"ISO3"},"residency":{"type":"string","description":"ISO3"},"nationality":{"type":"string","description":"ISO3"},"location":{"type":"string","description":""},"departure_date":{"type":"string","format":"date","description":""},"return_date":{"type":"string","format":"date","description":""},"requested_activity":{"type":"string","description":""},"email":{"type":"string","description":"","format":"email"},"host":{"type":"string","description":""}},"required":["destination","residency","nationality","location","departure_date","return_date"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"destination":{"type":"string","description":"ISO3"},"residency":{"type":"string","description":"ISO3"},"nationality":{"type":"string","description":"ISO3"},"location":{"type":"string","description":""},"departure_date":{"type":"string","format":"date","description":""},"return_date":{"type":"string","format":"date","description":""},"requested_activity":{"type":"string","description":""},"email":{"type":"string","description":"","format":"email"},"host":{"type":"string","description":""}},"required":["destination","residency","nationality","location","departure_date","return_date"]}}}}}}}}
```
## Re-open a business visa assessment you already ran, without paying to run it again — so a traveller can come back to their options, compare them, or apply later. Returns the same answer and entry options as before. Read-only — results are from when the check ran, not re-checked against today's rules.
> Re-open a business visa assessment you already ran, without paying to run it again — so a traveller can come back to their options, compare them, or apply later. Returns the same answer and entry options as before. Read-only — results are from when the check ran, not re-checked against today's rules.\
> \
\
\
> \Authentication:\ required
```json
{"openapi":"3.0.0","info":{"title":"v3","version":"0.0.1"},"servers":[{"url":"https://api.visadoc.co/api:v3"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}}},"paths":{"/assessments/{assessment_id}":{"get":{"operationId":"v3/assessments/{assessment_id}|GET","summary":"Re-open a business visa assessment you already ran, without paying to run it again — so a traveller can come back to their options, compare them, or apply later. Returns the same answer and entry options as before. Read-only — results are from when the check ran, not re-checked against today's rules.","description":"Re-open a business visa assessment you already ran, without paying to run it again — so a traveller can come back to their options, compare them, or apply later. Returns the same answer and entry options as before. Read-only — results are from when the check ran, not re-checked against today's rules.\n
\nAuthentication: required","tags":["assessments"],"parameters":[{"name":"assessment_id","in":"path","description":"","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success!","content":{"application/json":{"schema":{"type":"object","description":""}}}},"400":{"description":"Input Error. Check the request payload for issues."},"401":{"description":"Unauthorized"},"403":{"description":"Access denied. Additional privileges are needed access the requested resource."},"404":{"description":"Not Found. The requested resource does not exist."},"429":{"description":"Rate Limited. Too many requests."},"500":{"description":"Unexpected error"}}}}}}
```