visa-check

{'type': 'object', 'required': ['passport', 'destination'], 'properties': {'purpose': {'type': 'string', 'description': 'Travel purpose (default: tourism)'}, 'transit': {'type': 'string', 'description': 'Optional transit country, ISO 3166-1 alpha-3'}, 'passport': {'type': 'string', 'description': 'Passport country, ISO 3166-1 alpha-3 (e.g. NLD)'}, 'visas_of': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Issuers of visas held (ISO3 or SCHENGEN/EU/GCC)'}, 'destination': {'type': 'string', 'description': 'Destination country, ISO 3166-1 alpha-3 (e.g. JPN)'}, 'residence_permits_of': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Issuers of residence permits held (ISO3 or SCHENGEN/EU/GCC)'}}}

{'type': 'object', 'properties': {'apply': {'type': ['object', 'null'], 'properties': {'url': {'type': 'string', 'description': 'Official portal URL'}, 'kind': {'type': 'string', 'description': 'evisa | eta | visa_info'}, 'source': {'type': 'object', 'properties': {'url': {'type': 'string', 'description': 'Official page the rule was verified against'}, 'name': {'type': 'string', 'description': 'Official authority name'}, 'retrieved_at': {'type': 'string', 'description': 'YYYY-MM-DD the source was last retrieved'}}, 'description': 'Official-source citation for the field it accompanies', 'additionalProperties': True}}, 'description': 'Official government application/information portal when action is required', 'additionalProperties': True}, 'request_id': {'type': 'string', 'description': 'Unique id for reproducibility'}, 'entry_rules': {'type': 'object', 'description': 'Destination entry rules: passport_validity, blank_pages, onward_ticket, yellow_fever, other_health, twov (transit-without-visa), residence_permit_exemptions, official_links, purpose_scope — each non-null field cites its official source {name, url, retrieved_at}, plus last_verified and coverage (extended|basic).', 'additionalProperties': True}, 'requirement': {'type': 'string', 'description': 'visa_free | visa_on_arrival | e_visa | eta | visa_required | no_admission | unknown | needs_review'}, 'dataset_version': {'type': 'string', 'description': 'Base-matrix revision (YYYY-MM-DD)'}, 'defaults_applied': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Assumptions applied to answer (e.g. purpose=tourism, ordinary passport)'}, 'allowed_stay_days': {'type': ['number', 'null'], 'description': 'Maximum stay in days when the verdict grants one'}, 'requirement_label': {'type': 'string', 'description': 'Human-readable verdict'}, 'verdict_verification': {'type': 'object', 'description': 'Provenance of the visa verdict itself — always derives from an aggregated secondary matrix (status secondary_source_only or needs_review), never claimed officially verified', 'additionalProperties': True}, 'entry_rules_verification': {'type': 'object', 'description': 'Provenance of the curated entry-rules layer: verified_official_sources | stale | not_curated | needs_review, with last_verified and staleness_days', 'additionalProperties': True}}, 'description': "Visa verdict with entry rules and split provenance. Unknown or conflicting data is served as requirement 'unknown'/'needs_review' with action check_official_authority — never guessed.", 'additionalProperties': True}

{'type': 'object', 'required': ['traveler', 'trip'], 'properties': {'trip': {'type': 'object', 'required': ['legs'], 'properties': {'legs': {'type': 'array', 'items': {'type': 'object', 'required': ['country'], 'properties': {'role': {'enum': ['entry', 'transit'], 'type': 'string', 'description': 'entry = enter the country; transit = pass through in transit'}, 'country': {'type': 'string', 'description': 'Leg country, ISO 3166-1 alpha-3'}, 'purpose': {'type': 'string', 'description': 'Overrides the trip purpose for this leg'}, 'arrival_date': {'type': 'string', 'description': 'YYYY-MM-DD; enables stay-duration and validity-window checks'}, 'departure_date': {'type': 'string', 'description': 'YYYY-MM-DD; enables stay-duration and validity-window checks'}}}, 'description': 'Trip legs in order, up to 10'}, 'purpose': {'type': 'string', 'description': 'Trip-wide travel purpose (default: tourism); per-leg purpose overrides'}}, 'description': 'The itinerary to evaluate, in travel order'}, 'traveler': {'type': 'object', 'required': ['passports'], 'properties': {'visas_of': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Issuers of valid visas held (ISO3 or SCHENGEN/EU/GCC)'}, 'passports': {'type': 'array', 'items': {'type': 'string'}, 'description': 'ISO3, 1-4 passports'}, 'residence_permits_of': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Issuers of residence permits held (ISO3 or SCHENGEN/EU/GCC)'}}, 'description': "The traveler's documents"}}}

{'type': 'object', 'properties': {'legs': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}, 'description': 'One decision per leg: requirement, best_option (which held passport/document wins), why[] explanations with sources, conditions[] (validity, onward ticket, yellow fever, stay-duration fit), and a verification state'}, 'error': {'type': 'string', 'description': "Present on the unpaid path: 'payment_required'"}, 'trip_summary': {'type': 'object', 'description': 'Aggregate outcome', 'additionalProperties': True}, 'x402_requirements': {'type': ['object', 'null'], 'description': 'x402 v2 payment requirements (decoded from the PAYMENT-REQUIRED header): pay in USDC on Base and retry the same call', 'additionalProperties': True}}, 'description': 'Per-leg decisions with explanations, or — when the request carried no x402 payment — the machine-readable payment instructions to settle and retry.', 'additionalProperties': True}

{'type': 'object', 'properties': {}}

{'type': 'object', 'properties': {'data': {'type': 'object', 'properties': {'retrieved_at': {'type': 'string', 'description': 'Base-matrix revision (YYYY-MM-DD)'}}, 'additionalProperties': True}, 'docs': {'type': 'string', 'description': 'LLM-facing documentation URL'}, 'transparency': {'type': 'string', 'description': 'Data-quality metrics URL'}, 'free_endpoint': {'type': 'object', 'properties': {'url': {'type': 'string'}, 'limit': {'type': 'string', 'description': 'Free-tier quota'}, 'price': {'type': 'string'}}, 'description': 'The free rate-limited check endpoint', 'additionalProperties': True}, 'paid_endpoints': {'type': 'object', 'properties': {'check': {'type': 'object', 'additionalProperties': True}, 'matrix': {'type': 'object', 'additionalProperties': True}, 'evaluate': {'type': 'object', 'additionalProperties': True}}, 'description': 'x402 pay-per-request endpoints (USDC on Base, no account)', 'additionalProperties': True}}, 'description': 'Dataset revision plus the free and x402-paid endpoints with current prices', 'additionalProperties': True}