---
title: "Visa requirement for a passport → destination pair from Finding Horizons' scraped visa database (grounded in the live Wi"
method: POST
path: "/actions/search_visa_rules"
tags: ["reference"]
---

# Visa requirement for a passport → destination pair from Finding Horizons' scraped visa database (grounded in the live Wi

`POST /actions/search_visa_rules`

## Request

- Base URL: `https://findinghorizons.ca/api/v1`
- URL: `https://findinghorizons.ca/api/v1/actions/search_visa_rules`
- Auth: OAuth 2 (authorization code, authorization URL `https://findinghorizons.ca/api/mcp/authorize`, token URL `https://findinghorizons.ca/api/mcp/oauth/token`, scopes: `reference:read`)

Visa requirement for a passport → destination pair from Finding Horizons' scraped visa database (grounded in the live Wikipedia visa-requirements tables, refreshed on a schedule). Returns the requirement category, visa-free days, and any notes. No AI involved — this is the stored ground truth.

## Request body

- object
  - `passport` string, required: Passport country — ISO-2 code or name, e.g. "CA" or "Canada"
  - `destination` string, required: Destination country — ISO-2 code or name, e.g. "TH" or "Thailand"
  - `today` string: The traveller's own date, YYYY-MM-DD, where the action needs one

## Response `200`

Done — { ok, api, action, result, card, operation? }

## Other responses

- `400`: Bad body / missing Idempotency-Key
- `401`: No or invalid token
- `403`: Scope not granted
- `422`: The action said no
- `429`: Rate limited

---

[API](https://skmtc.dev/findinghorizons/apis/finding-horizons-api.md) · [All operations](https://skmtc.dev/findinghorizons/apis/finding-horizons-api/llms.txt) · [OpenAPI document](https://skmtc.dev/findinghorizons/apis/finding-horizons-api/revisions/e347f6070173?raw)