{"uid":"cap_uOKAOUiO8yDHPkcNeuXHY","slug":"shoppi-backend-onrender-com-1aff14ff","name":"Shoppi Mobile Top-Up Supported Countries","description":"Returns the list of supported country codes for mobile top-up services.","url":"https://shoppi-backend.onrender.com/api/catalog/topups/countries","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":{}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"array","items":{"type":"object","required":["code"],"properties":{"code":{"type":"string"}}}},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{}}},"response":[{"code":"IL"},{"code":"NG"},{"code":"AF"},{"code":"AO"},{"code":"CD"},{"code":"GM"},{"code":"SL"},{"code":"GH"},{"code":"BD"},{"code":"IN"},{"code":"KE"},{"code":"MG"},{"code":"MW"},{"code":"NE"},{"code":"RW"},{"code":"TZ"},{"code":"UG"},{"code":"ZM"},{"code":"EC"},{"code":"LB"},{"code":"BR"},{"code":"BS"},{"code":"DO"},{"code":"IQ"},{"code":"MX"},{"code":"US"},{"code":"ID"},{"code":"DE"},{"code":"UZ"},{"code":"PE"},{"code":"ES"},{"code":"TT"},{"code":"KH"},{"code":"CM"},{"code":"MY"},{"code":"GN"},{"code":"ZA"},{"code":"CN"},{"code":"AR"},{"code":"CL"},{"code":"CO"},{"code":"CR"},{"code":"GT"},{"code":"HN"},{"code":"NI"},{"code":"PR"},{"code":"SV"},{"code":"CU"},{"code":"LK"},{"code":"BZ"},{"code":"AG"},{"code":"AI"},{"code":"AW"},{"code":"BB"},{"code":"BM"},{"code":"BQ"},{"code":"CW"},{"code":"DM"},{"code":"FJ"},{"code":"GD"},{"code":"GY"},{"code":"HT"},{"code":"JM"},{"code":"KN"},{"code":"KY"},{"code":"LC"},{"code":"MS"},{"code":"SR"},{"code":"TC"},{"code":"VC"},{"code":"VG"},{"code":"WS"},{"code":"VE"},{"code":"PH"},{"code":"DZ"},{"code":"TH"},{"code":"AE"},{"code":"ZW"},{"code":"BO"},{"code":"CY"},{"code":"ET"},{"code":"EG"},{"code":"VN"},{"code":"PL"},{"code":"SO"},{"code":"MA"},{"code":"PK"},{"code":"CA"},{"code":"ML"},{"code":"BW"},{"code":"PA"},{"code":"BJ"},{"code":"CI"},{"code":"GA"},{"code":"TG"},{"code":"UY"},{"code":"MZ"},{"code":"MM"},{"code":"CG"},{"code":"GW"},{"code":"LR"},{"code":"SD"},{"code":"SZ"},{"code":"RU"},{"code":"NP"},{"code":"BF"},{"code":"TN"},{"code":"JO"},{"code":"RO"},{"code":"SN"},{"code":"PY"},{"code":"YE"},{"code":"SA"},{"code":"CF"},{"code":"KM"},{"code":"IT"},{"code":"TR"},{"code":"SS"}]},"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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_rWRdSXC7Rb3PqFETRILb5","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the list of ISO country codes where mobile top-up services are available","exampleAgentPrompt":"Can you show me the full list of countries where I can send a mobile top-up or airtime recharge through Shoppi?","exampleUseCases":[{"title":"Validate customer country for airtime","prompt":"Before we let this customer buy airtime, can you check if their country is on the list of places where we support mobile top-ups?"},{"title":"Build international top-up service picker","prompt":"I need to show our users which countries they can recharge phones in. Can you pull the complete list of supported countries for mobile top-up so I can populate the dropdown?"},{"title":"Check market availability for expansion","prompt":"We're thinking about expanding our payment service to Ghana and Kenya. Can you look up whether those countries are already in the Shoppi mobile top-up network?"}],"resultDescription":"An array of objects each containing a 'code' field with an ISO 3166-1 alpha-2 country code (e.g. {\"code\":\"NG\"}, {\"code\":\"US\"}), representing all countries where mobile top-up services are supported on the platform.","failureModes":["Service temporarily unavailable due to Render.com cold start (503 or timeout on first request)","Empty or partial list returned if upstream provider catalog is degraded","Payment failure if x402 micropayment of $0.001 USDC is not properly handled"],"whenToPreferThis":"Use this endpoint when you need to validate whether a specific country is supported before attempting a mobile top-up, or when building a country picker UI for a top-up flow. Prefer this over hardcoding country lists as it reflects live catalog availability.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:40:08.910Z","isFirstParty":false}