# Country Facts – Border Path Finder

> Country Facts – Border Path Finder is a paid API for AI agents from country-facts.x402tookit.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-30).

Returns the fewest-land-border-crossings route between two countries, listing each country passed through, or NO_LAND_ROUTE if none exists.

## Facts

- Endpoint: GET https://country-facts.x402tookit.com/border-path?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/country-facts-border-path-finder-c022ac8f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_tG1qSJrCiqsAerFqqDtXg

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability country-facts-border-path-finder-c022ac8f
```

Example prompt: How many land border crossings would I need to make to travel from France to India, and which countries would I pass through along the way?

## When to prefer this

Use this endpoint when you need to determine the minimum number of land border crossings between two specific countries and the exact sequence of countries on that path. Prefer this over a general country-facts or neighbors endpoint when the goal is routing or overland travel planning rather than simply listing adjacent countries. It is purpose-built for border-path computation and returns a richer result (full path, crossing count, NO_LAND_ROUTE verdict) than a neighbors list.

## Known failure modes

- Unrecognized country name or ISO code returns an error or empty result
- Island nations with no land borders return NO_LAND_ROUTE
- Disputed territories or recent geopolitical changes may produce outdated or degraded results (flagged via degraded field)
- Some border crossing passability (e.g. closed borders) may not be checked (notChecked array)
- Missing required 'from' or 'to' query params returns a 400-level error

## How this service works

Fewest land border crossings between two countries, with the countries passed through, or NO_LAND_ROUTE.

## Output

Returns the origin and destination country details (name, ISO alpha2/alpha3), the ordered list of countries along the shortest land-border path (each with name, alpha2, alpha3), the number of crossings, a human-readable summary, a verdict string, and a NO_LAND_ROUTE verdict if no overland route exists. Also includes metadata like data freshness (asOf), degraded-mode flag, and any disclaimers.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "from",
      "to"
     ],
     "properties": {
      "to": {
       "type": "string",
       "description": "End country, ISO code or English name"
      },
      "from": {
       "type": "string",
       "description": "Start country, ISO code or English name"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "to": {
       "type": [
        "null",
        "object"
       ],
       "properties": {
        "name": {
         "type": [
          "null",
          "string"
         ]
        },
        "alpha2": {
         "type": [
          "null",
          "string"
         ]
        },
        "alpha3": {
         "type": [
          "null",
          "string"
         ]
        }
       }
      },
      "asOf": {
       "type": [
        "null",
        "string"
       ]
      },
      "from": {
       "type": [
        "null",
        "object"
       ],
       "properties": {
        "name": {
         "type": [
          "null",
          "string"
         ]
        },
        "alpha2": {
         "type": [
          "null",
          "string"
         ]
        },
        "alpha3": {
         "type": [
          "null",
          "string"
         ]
        }
       }
      },
      "path": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "object",
        "properties": {
         "name": {
          "type": [
           "null",
           "string"
          ]
         },
         "alpha2": {
          "type": [
           "null",
           "string"
          ]
         },
         "alpha3": {
          "type": [
           "null",
           "string"
          ]
         }
        }
       }
      },
      "source": {
       "type": [
        "null",
        "string"
       ]
      },
      "reasons": {
       "type": [
        "array",
        "null"
      
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/country-facts-border-path-finder-c022ac8f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from country-facts.x402tookit.com](https://www.zero.xyz/host/country-facts.x402tookit.com/llms.txt)