{"uid":"cap_r1tkER2duu5EkH5hbgqco","slug":"apiosk-gateway-countrylayer-execute-25204c09","name":"Apiosk Gateway – Countrylayer Execute","description":"Pay-per-call API gateway on the x402 protocol (HTTP 402 + USDC on Base). This document covers the gateway's discovery and execution meta-endpoints. Individual provider APIs are reachable at /{api_slug}/{path} and described by GET /{api_slug}/metadata.","url":"https://gateway.apiosk.com/countrylayer/execute","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"input":{"type":"string","description":"JSON payload forwarded to the selected operation."},"operation":{"type":"string","description":"Operation id, /path, or METHOD /path selector."}}},"responseSchema":{"type":"object","required":["status","result"],"properties":{"api":{"type":"string"},"cost":{"type":"string"},"result":{"description":"Upstream response body."},"status":{"type":"string"},"latency":{"type":"number"},"operation":{"type":"string"},"upstream_status":{"type":"integer"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.0805","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.07/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.07","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.07","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm__nw2m4_ANfYObtItNlo2y","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.07","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Executes a pay-per-call request to the Countrylayer country data API via the Apiosk x402 gateway, forwarding operations and JSON payloads upstream and returning the result.","exampleAgentPrompt":"Look up all the details for Germany using Countrylayer — I need the capital, currency, official languages, calling code, and ISO codes.","exampleUseCases":[{"title":"Country profile for onboarding form","prompt":"I'm building a user onboarding flow and need the full profile for Brazil — capital city, currency, ISO alpha-2 and alpha-3 codes, official language, and dialing code. Can you pull that from Countrylayer?"},{"title":"Continent country listing for a dropdown","prompt":"Can you get me a list of all countries in Southeast Asia from Countrylayer so I can populate a region filter in my app?"},{"title":"Currency and timezone lookup for invoicing","prompt":"I need the currency code and timezone for Japan using Countrylayer so I can correctly format an invoice for a client there."}],"resultDescription":"Returns a JSON object containing the upstream Countrylayer API response body (country data such as names, codes, capitals, currencies, languages, timezones, and flags), along with gateway metadata including the operation invoked, HTTP status from upstream, latency in milliseconds, and cost of the call in USDC.","failureModes":["Invalid or unrecognized operation selector returns an error status with no upstream result","Malformed JSON in the input payload causes a parsing error","Country name or code not found returns an empty result or 404 upstream status","Insufficient USDC balance or failed x402 payment results in HTTP 402 and no execution","Upstream Countrylayer service unavailable returns a non-200 upstream_status"],"whenToPreferThis":"Choose this endpoint when you need structured, authoritative country reference data (codes, capitals, currencies, languages, timezones) and are already operating in an x402/USDC micropayment environment on Base. Prefer it over direct Countrylayer API calls when you want pay-per-call billing without managing API keys, or when your agent workflow is already using the Apiosk gateway for other data providers.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:43:18.375Z","isFirstParty":false}