Consulta de visado
Con pasaporte de Estados Unidos, México no exige visado para estancias de hasta 180 días, según una pequeña tabla fija de 25 pares de países. Indique los códigos de dos letras de pasaporte y destino y vea uno de tres estados de visado. Gratis en su navegador.
- Gratis
- Funciona en su navegador
- Sin registro
- Sus datos no salen de su equipo
Ejecutar — gratis
Ejemplo resuelto
- País del pasaporte
- US
- País de destino
- MX
- Clave del par
- US>MX
- Estado de la visa
- visa_free
- Etiqueta de estado
- Visa-free
- Tamaño de la mesa
- 25
Planificar un viaje internacional casi siempre empieza por la misma pregunta práctica: ¿su pasaporte necesita visado para ese destino? Esta consulta de requisito de visado acepta el país del pasaporte del viajero y el país de destino como códigos ISO 3166-1 alpha-2, busca el par ordenado en una tabla de referencia fija integrada y devuelve uno de tres estados claros: visado obligatorio antes del viaje, visado a la llegada o entrada sin visado. Son datos educativos y fáciles de integrar—no consejo embajador en vivo—, así que conviene verificar siempre los itinerarios críticos con fuentes oficiales antes de salir.
Qué significan los valores de estado de visado y cómo funciona la búsqueda
Esta capacidad responde a una pregunta acotada y de alto valor: para un país emisor de pasaporte y un país de destino dados, ¿qué dice la tabla de referencia stub sobre las formalidades de entrada? Se admiten tres resultados. Visa required significa que el viajero debe obtener un visado (o una autorización electrónica aprobada tratada como visado previo) antes del embarque o del control fronterizo; la respuesta no inventa URL de consulados ni formularios, solo etiqueta el estado para que su producto pueda reconducir al usuario al siguiente paso.
Visa on arrival indica que la tabla registra que un visado o permiso equivalente puede concederse en el puerto de entrada según las reglas del stub, a menudo con una estancia máxima sugerida en días cuando la fila incluye ese detalle. Visa-free indica que la tabla registra que la entrada de corta estancia no exige una solicitud de visado aparte para ese pasaporte y destino bajo los datos del stub.
El algoritmo es deliberadamente simple y determinista: normaliza ambos campos de país a códigos ISO 3166-1 alpha-2 de dos letras en mayúsculas, rechaza códigos mal formados y pares del mismo país, construye una clave de par de la forma PASSPORT greater-than DESTINATION y consulta un mapa hash en memoria.
Recuerde que la política real de visados cambia con la nacionalidad, el motivo del viaje, denegaciones previas y acuerdos bilaterales; este stub congela un conjunto educativo pequeño para que los equipos de ingeniería conecten la UX y la facturación sin raspar la web ni llamar a APIs de visados de pago durante el desarrollo.
Cuándo sirve una consulta rápida de visado
Los marketplaces de viajes y las sandboxes de reserva necesitan una señal fiable para mostrar insignias de visado obligatorio antes de abandonar el carrito, pero las fuentes gubernamentales en vivo son inestables, limitadas o con licencia. Un stub de capa parse con tabla fija permite a los equipos de producto publicar la ruta de UX, escribir pruebas de extremo a extremo y formar a soporte sobre tres estados discretos sin depender de la red.
Las plataformas educativas y de examen que enseñan normativa turística pueden evaluar a los alumnos sobre códigos ISO de país y mapear estados sin raspar Wikipedia. Las herramientas internas que normalizan registros de nombre de pasajero a menudo necesitan una comprobación secundaria barata: dado el país emisor del pasaporte y el destino del itinerario, adjuntar un indicador stub para revisión operativa. La validación fallida no consume saldo.
Qué puede hacer con ella
Insignias de visado en reserva y pago
Muestre etiquetas sin visado, visado a la llegada o visado obligatorio en resúmenes de viaje cuando el par pasaporte del pasajero y destino exista en la tabla stub.
Preguntas frecuentes
¿Qué ocurre si el par de países no está en la tabla de referencia?
El stub nunca inventa una política de visado para combinaciones desconocidas de pasaporte y destino, y la validación fallida no se factura.
¿Es esto consejo oficial de visados en vivo?
No. Es una tabla de referencia stub determinista para demos de producto, pruebas y consultas educativas. Confirme siempre las normas de entrada con embajadas o fuentes oficiales antes de viajar.
¿Qué formato de código de país se acepta?
Solo códigos ISO 3166-1 alpha-2 de dos letras, sin distinguir mayúsculas (US, us y Us se normalizan a US). Se rechazan códigos de tres letras, nombres como México y pares del mismo país.
¿Qué significan los tres estados de visado?
Visado obligatorio significa obtener un visado o una autorización electrónica aprobada antes de viajar. Visado a la llegada indica que el permiso puede concederse en la frontera. Sin visado indica una estancia corta sin solicitud aparte.
¿El resultado dice cuánto tiempo puedo quedarme?
Solo cuando la fila de la tabla incluye una estancia máxima. Para un pasaporte estadounidense con destino a México indica hasta 180 días; en los pares sin ese dato no se da ningún límite.
Herramientas relacionadas
Para desarrolladores — acceso por API
Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.
Endpoint de API
¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, por email y desde Telegram — y pronto también desde nuestra app.
Llámela desde su stack
curl -X POST https://api.kit.forhosting.com/travel/visa-required-check-stub \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"passport_country":"US","destination_country":"MX"}'const res = await fetch("https://api.kit.forhosting.com/travel/visa-required-check-stub", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"passport_country": "US",
"destination_country": "MX"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/travel/visa-required-check-stub",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"passport_country": "US",
"destination_country": "MX"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/travel/visa-required-check-stub", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"passport_country":"US","destination_country":"MX"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"passport_country":"US","destination_country":"MX"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/travel/visa-required-check-stub", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Ejemplo de solicitud
{
"passport_country": "US",
"destination_country": "MX"
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "travel.visa_required_check_stub",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.
Precio
Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.
Errores
| HTTP | Código | Significado |
|---|---|---|
401 | unauthorized | API key ausente o inválida. |
402 | insufficient_balance | El saldo no cubre el precio de la tarea. |
404 | unknown_type | El tipo de tarea no existe. |
429 | rate_limited | Demasiadas peticiones. Use el webhook en vez de sondear. |
Notas técnicas
Cuando el par no está en la tabla, la llamada falla con invalid_input en lugar de inventar una norma.
Qué significan los valores de estado de visado y cómo funciona la búsqueda
Un acierto devuelve visa_status, un status_label legible, max_stay_days opcional cuando se conoce, notes y metadatos como table_size y method. Un fallo lanza invalid_input nombrando el par ausente.
Contrato de entrada, forma de la respuesta y comportamiento de error
Se rechazan cargas numéricas u objetos en esos campos. Si ambos códigos son válidos pero idénticos, el manejador rechaza la petición porque el viaje doméstico queda fuera del alcance de una consulta de visado transfronteriza. Si ambos códigos son válidos y distintos pero el par ordenado no está en la tabla de referencia integrada, la tarea falla con un mensaje claro de que el par de países no está en la tabla de referencia—esos fallos no se facturan. Combine la respuesta con sus propios formularios de elegibilidad, captura de foto de pasaporte o enlaces profundos a embajadas si necesita un embudo completo de solicitud; este extremo solo clasifica el par frente a la tabla de referencia y no tramita solicitudes, no recoge biometría ni consulta listas de vigilancia. Envíe un cuerpo JSON por POST con dos campos de cadena obligatorios: passport_country y destination_country. Cada valor debe ser un código de país ISO 3166-1 alpha-2 de dos letras; se ignora mayúsculas/minúsculas, se recortan espacios y cualquier cosa que no sean exactamente dos letras latinas tras la normalización falla con invalid_input nombrando el campo. En éxito el cuerpo repite passport_country y destination_country normalizados, el pair_key usado en la consulta, visa_status como uno de visa_required, visa_on_arrival o visa_free, un status_label apto para la interfaz, notes que describen la fila del stub, in_reference_table en true, method en stub_reference_table_lookup y table_size igual al número de pares enviados actualmente. Cuando la fila incluye una estancia máxima positiva, max_stay_days aparece como entero; cuando el stub no define límite de estancia para ese par el campo se omite por completo en lugar de devolver null, conforme al contrato del renderizador para salidas opcionales. Ejemplo: passport_country US y destination_country MX produce visa_free con un max_stay_days de varios meses en la tabla stub. Ejemplo: passport_country US y destination_country CN produce visa_required sin max_stay_days.
Dónde un API stub de requisito de visado aporta valor
Como la implementación es parse pura de nivel A, cada llamada exitosa cuesta el precio base publicado $0.002 sin tokens de modelo y sin red saliente. Esa combinación ofrece valores de visa_status reproducibles para demos, plugins LMS y edge workers sin montar su propia tubería de datos geopolíticos.
Casos de integración
QA y regresión golden para la UX de viajes
Impulse pruebas deterministas de flujos de alta de viaje con pares ISO fijos en lugar de scrapers inestables de embajadas en vivo.
Widgets educativos y de contenido
Permita a alumnos y lectores consultar estados de muestra pasaporte–destino en el navegador con la misma lógica que la API factura a $0.002.
Preguntas técnicas
¿Cómo compruebo si se exige visado para mi destino?
Envíe passport_country y destination_country como códigos ISO 3166-1 alpha-2 (por ejemplo US y MX). La API devuelve visa_status como visa_required, visa_on_arrival o visa_free cuando el par está en la tabla de referencia.
¿Cuánto cuesta la consulta de requisito de visado?
La herramienta del navegador es gratuita. Las peticiones API usan saldo prepago KIT a $0.002 por llamada exitosa; la entrada inválida no se factura.