{"uid":"cap_uBFfOit9H_kNfZrKaegZm","slug":"country-info-lookup-by-name-or-iso-code-e3fdcd40","name":"Country Info Lookup by Name or ISO Code","description":"Country facts by name or ISO code: official name, capital, region, currencies, languages, timezones, dialing code, TLD, and more. Committed open dataset (world-countries, ODbL, plus the IANA timezone country map) - offline and deterministic. ?name=Japan or ?code=JP","url":"https://agent402.tools/api/country-info","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","properties":{"code":{"type":"string","description":"alternative: ISO 3166-1 alpha-2 or alpha-3 code, e.g. JP or JPN"},"name":{"type":"string","description":"country name (common or official), e.g. Japan"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["query","found","matches","country"],"properties":{"found":{"type":"boolean"},"query":{"type":"string"},"country":{"type":"object"},"matches":{"type":"integer"}}}}}}},"responseSchema":{"type":"json","example":{"found":true,"query":"Japan","country":{"tld":".jp","area":377930,"flag":"🇯🇵","name":"Japan","code2":"JP","code3":"JPN","latlng":[36,138],"region":"Asia","borders":[],"capital":"Tokyo","demonym":"Japanese","unMember":true,"languages":["Japanese"],"subregion":"Eastern Asia","timezones":["Asia/Tokyo"],"currencies":[{"code":"JPY","name":"Japanese yen","symbol":"¥"}],"landlocked":false,"callingCode":"+81","officialName":"Japan"},"matches":1}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_VgFhA8iJiyOY-N9n4vEyv","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","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, currencies, languages, timezones, dialing code, TLD, and more) given a country name or ISO 3166-1 alpha-2/alpha-3 code.","exampleAgentPrompt":"What is the official name, capital, currency, languages, timezone, dialing code, and TLD for Japan? Look up by ISO code JPN.","exampleUseCases":null,"resultDescription":"A structured object containing the country's official and common name, capital city, geographic region, list of currencies (with codes and symbols), official languages, timezones, international dialing code, and country-code top-level domain (ccTLD). Data is served offline from a committed open dataset, so results are deterministic and consistent across calls.","failureModes":["Unknown country name or code returns a 404 or empty result","Misspelled country name may not match — use ISO code for precision","Ambiguous common names (e.g. 'Congo') may return unexpected results — prefer ISO alpha-2/alpha-3","Non-country territories or disputed regions may not be present in the dataset"],"whenToPreferThis":"Choose this endpoint when you need structured, authoritative country metadata (capital, currencies, languages, timezones, dialing codes, TLD) from a stable offline dataset. Prefer it over live web lookups when determinism and offline reliability matter. It supports both human-readable country names and ISO 3166-1 alpha-2/alpha-3 codes, making it ideal for data enrichment pipelines, form validation, or agents that need to resolve country identifiers.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:53:56.827Z","isFirstParty":false}