{"uid":"cap_rKTNmjUizyhBPHACXfCf4","slug":"country-facts-border-neighbours-4290bc2e","name":"Country Facts – Border Neighbours","description":"List a country's land neighbours, or all countries within 2-3 border crossings, with landlocked status.","url":"https://country-facts.x402tookit.com/borders?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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":["country"],"properties":{"depth":{"type":"integer","description":"Border crossings out to include, 1-3 (default 1)"},"country":{"type":"string","description":"ISO code or English name, e.g. Germany"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"asOf":{"type":["null","string"]},"rings":{"type":["array","null"],"items":{"type":"object","properties":{"count":{"type":["null","number"]},"countries":{"type":["array","null"],"items":{"type":"object","properties":{"name":{"type":["null","string"]},"alpha2":{"type":["null","string"]},"alpha3":{"type":["null","string"]}}}},"crossings":{"type":["null","number"]}}}},"source":{"type":["null","string"]},"country":{"type":["null","object"],"properties":{"name":{"type":["null","string"]},"alpha2":{"type":["null","string"]},"alpha3":{"type":["null","string"]}}},"reasons":{"type":["array","null"],"items":{"type":"string"}},"summary":{"type":["null","string"]},"verdict":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"disclaimer":{"type":["null","string"]},"landlocked":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"neighbourCount":{"type":["null","number"]}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_OtznhtjtsvM1QT7Ajw0SP","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a country's direct land neighbours or all countries reachable within 1–3 border crossings, including landlocked status.","exampleAgentPrompt":"What countries border Poland, and which ones can I reach within 2 border crossings? Also tell me if Poland is landlocked.","exampleUseCases":[{"title":"Travel route planning through Europe","prompt":"I'm planning an overland trip starting from Hungary — can you show me all the countries I could reach within 2 border crossings, and tell me which of those are landlocked?"},{"title":"Supply chain corridor analysis","prompt":"We're mapping land freight routes from Germany — list all countries reachable within 3 border crossings from Germany so we can identify potential transit nations."},{"title":"Geography quiz answer verification","prompt":"Is Bolivia landlocked, and what are its direct land neighbours? I need the official country names and their ISO codes."}],"resultDescription":"Returns a structured response with the queried country's name and ISO codes, its landlocked status, and one or more 'rings' — each ring representing a border-crossing depth (1 = direct neighbours, 2 = neighbours of neighbours, etc.) with a list of countries at that depth (name, alpha2, alpha3), a count, and a human-readable summary. Also includes data freshness timestamp and source attribution.","failureModes":["Unknown country name or ISO code returns an error or empty result","Depth value outside 1–3 range may be rejected or defaulted","Island nations with no land borders return empty neighbour lists","Disputed territories may not be consistently represented","Payment failure (402) if USDC balance is insufficient"],"whenToPreferThis":"Choose this endpoint when you need structured, programmatic data about a country's land borders and geographic reachability — especially when you need multi-hop traversal (2–3 crossings) rather than just direct neighbours. Prefer over general-purpose geography APIs when landlocked status and ring-based reachability are needed together in a single call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T13:08:14.661Z","isFirstParty":false,"canonicalSlug":"country-facts-border-neighbours-4290bc2e"}