# Variables

## Request Variables

<table><thead><tr><th width="206">Variable</th><th width="152.5999755859375">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>id</code></td><td>number</td><td>Unique identifier for the visa application</td></tr><tr><td><code>created_at</code></td><td>number</td><td>Application creation timestamp (Unix milliseconds)</td></tr><tr><td><code>destination</code></td><td>string</td><td>ISO country code of destination country</td></tr><tr><td><code>residency</code></td><td>string</td><td>Country where applicant currently resides</td></tr><tr><td><code>nationality</code></td><td>string</td><td>Applicant's nationality/citizenship</td></tr><tr><td><code>location</code></td><td>string</td><td>Applicant's current location</td></tr><tr><td><code>departure_date</code></td><td>string</td><td>Planned departure date</td></tr><tr><td><code>return_date</code></td><td>string</td><td>Planned return date</td></tr><tr><td><code>number_of_entries</code></td><td>string</td><td>Requested entry type (e.g., "Single", "Multiple")</td></tr><tr><td><code>requested_activity</code></td><td>string</td><td>Purpose/nature of the visit</td></tr></tbody></table>

***

## Response Variables

#### Result Object

<table><thead><tr><th>Variable</th><th width="128.60009765625">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>visa_required</code></td><td>boolean</td><td>Whether a visa is mandatory for this trip</td></tr><tr><td><code>notes</code></td><td>string</td><td>Summary assessment of visa requirements</td></tr><tr><td><code>visa_research_status</code></td><td>string</td><td>Research completion status ("Ok" or "Additional research required")</td></tr><tr><td><code>categorized_visit_purposes</code></td><td>array</td><td>Classified/tagged reasons for travel</td></tr><tr><td><code>entry_options</code></td><td>array</td><td>Available visa options for this trip</td></tr></tbody></table>

#### Entry Options Array

<table><thead><tr><th width="225.39996337890625">Variable</th><th width="124.4000244140625">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>max_stay_valid</code></td><td>boolean</td><td>Whether trip duration fits within visa's maximum stay limit</td></tr><tr><td><code>processing_time_valid</code></td><td>boolean</td><td>Whether there's sufficient time for processing before departure</td></tr><tr><td><code>entry_option_priority</code></td><td>string</td><td>Priority level of this visa option ("main", "alternative", etc.)</td></tr><tr><td><code>issues</code></td><td>array</td><td>List of identified problems or concerns with this option</td></tr><tr><td><code>entry_option_score</code></td><td>number</td><td>Numerical rating/suitability score for this visa option</td></tr></tbody></table>

#### Entry Option Details

<table><thead><tr><th width="237">Variable</th><th width="122.199951171875">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>id</code></td><td>number</td><td>Unique identifier for this specific visa type</td></tr><tr><td><code>visa_title</code></td><td>string</td><td>Official name of the visa category</td></tr><tr><td><code>business_activities</code></td><td>string</td><td>Description of permitted business activities</td></tr><tr><td><code>visa_type</code></td><td>string</td><td>Application method ("Paper", "Electronic", "Visa On Arrival", "ETA/ESTA")</td></tr><tr><td><code>visa_validity_code</code></td><td>string</td><td>Internal code representing validity period</td></tr><tr><td><code>visa_validity</code></td><td>string</td><td>Human-readable visa validity duration</td></tr><tr><td><code>visa_validity_days</code></td><td>number</td><td>Visa validity period in days</td></tr><tr><td><code>max_length_of_stay_days</code></td><td>number</td><td>Maximum permitted stay duration (days)</td></tr><tr><td><code>max_length_of_stay</code></td><td>string</td><td>Human-readable maximum stay duration</td></tr><tr><td><code>application_fee_value</code></td><td>number</td><td>Numerical fee amount</td></tr><tr><td><code>application_fee_currency</code></td><td>string</td><td>Currency code for the fee</td></tr><tr><td><code>application_fee</code></td><td>string</td><td>Formatted fee amount with currency</td></tr><tr><td><code>procesing_time_days</code></td><td>number</td><td>Expected processing time in days</td></tr><tr><td><code>processing_time</code></td><td>string</td><td>Human-readable processing duration</td></tr><tr><td><code>destination</code></td><td>string</td><td>Destination country code</td></tr></tbody></table>

***

## Usage Notes

* All date fields should be in ISO 8601 format
* Country codes should follow ISO 3166-1 alpha-2 standard
* Currency codes should follow ISO 4217 standard
* Processing times and validity periods are estimates and may vary
* The `entry_options` array is sorted by `entry_option_priority` and `entry_option_score`