{"uid":"cap_hlrF548mgnsz-2_3zgZyy","slug":"country-facts-by-name-or-iso-code-f7e32427","name":"Country Facts by Name or ISO Code","description":"Facts about a country by name or ISO code: official name, capital, region, languages, currencies, calling code, borders, area, internet TLD, coordinates, UN membership and flag. Use to enrich addresses, forms and datasets.","url":"https://bess-x402.onrender.com/v1/geo/country?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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["country"],"properties":{"country":{"type":"string","description":"Country name or ISO-2/ISO-3 code"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_fEXmmv7YLlSLqIWE8aJFH","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns comprehensive country facts (official name, capital, region, languages, currencies, calling code, borders, area, TLD, coordinates, UN membership, flag) given a country name or ISO-2/ISO-3 code.","exampleAgentPrompt":"Can you look up the full country facts for Germany — I need its official name, capital, calling code, currency, languages, internet TLD, and which countries it borders?","exampleUseCases":[{"title":"Enrich user address form","prompt":"A user just entered 'DE' as their country code in our signup form — can you pull the full country details so I can auto-fill the region, calling code, and currency fields?"},{"title":"Dataset country metadata enrichment","prompt":"I have a list of country ISO codes in my dataset and I need to enrich each one with its official name, capital, region, and UN membership status — start with 'BRA'."},{"title":"App localization currency lookup","prompt":"What currency and calling code should I display for users from Japan? Look it up by country name."}],"resultDescription":"A structured JSON object containing the country's official name, capital, geographic region, list of languages, currencies, international calling code, list of bordering countries, total area in km², internet TLD, geographic coordinates (latitude/longitude), UN membership status, and flag (emoji or URL).","failureModes":["Unknown or misspelled country name returns an error or empty result","Ambiguous partial name may not resolve correctly","Rate limiting or payment failure if USDC balance is insufficient","Server unavailability on render.com free tier cold starts"],"whenToPreferThis":"Use this endpoint when you need rich, structured reference data about a country from a single lookup — especially when enriching forms, datasets, or user profiles with multiple country attributes at once. Prefer it over manual geocoding or Wikipedia scraping when you need standardized fields like ISO codes, calling codes, TLD, and UN membership in one call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-28T06:38:07.429Z","isFirstParty":false,"canonicalSlug":"country-facts-by-name-or-iso-code-f7e32427"}