{"uid":"cap_pzFvcjUpcrEXrjTg5U1ph","slug":"shoppi-backend-onrender-com-5beac598","name":"Shoppi Mobile Top-Up & Bundle Catalog","description":"Returns a catalog of prepaid mobile top-up and bundle offers, including offer IDs, carrier brands, countries, included voice/SMS/data allowances, and pricing details.","url":"https://shoppi-backend.onrender.com/api/catalog/topups/offers","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":{"limit":{"type":"number","description":"Results per page"},"offset":{"type":"number","description":"Pagination offset"},"country":{"type":"string","description":"ISO country code e.g. ES"},"operator":{"type":"string","description":"Mobile operator name"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"object","required":["list","limit","total","offset"],"properties":{"list":{"type":"array","items":{"type":"object","required":["brand","notes","price","dataGB","country","offerId","regions","subTypes","brandName","priceType","smsNumber","shortNotes","productType","durationDays","smsUnlimited","voiceMinutes","dataUnlimited","voiceUnlimited"],"properties":{"brand":{"type":"string"},"notes":{"type":"string"},"price":{"type":"object","required":["fx","fee","fixed","margin","currency","suggestedFixed","currencyDivisor"],"properties":{"fx":{"type":"number"},"fee":{"type":"number"},"fixed":{"type":"number"},"margin":{"type":"number"},"currency":{"type":"string"},"suggestedFixed":{"type":"number"},"currencyDivisor":{"type":"number"}}},"dataGB":{"type":"number"},"country":{"type":"string"},"offerId":{"type":"string"},"regions":{"type":"array","items":{"type":"string"}},"subTypes":{"type":"array","items":{"type":"string"}},"brandName":{"type":"string"},"priceType":{"type":"string"},"smsNumber":{"type":"number"},"shortNotes":{"type":"string"},"productType":{"type":"string"},"durationDays":{"type":"number"},"smsUnlimited":{"type":"boolean"},"voiceMinutes":{"type":"number"},"dataUnlimited":{"type":"boolean"},"voiceUnlimited":{"type":"boolean"}}}},"limit":{"type":"number"},"total":{"type":"number"},"offset":{"type":"number"}}},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"limit":10,"offset":0,"country":"ES"}}},"response":{"list":[{"brand":"Digimobil","notes":"","price":{"fx":0.829876,"fee":0,"fixed":1205,"margin":0.0439834,"currency":"USD","suggestedFixed":1205,"currencyDivisor":100},"dataGB":0,"country":"ES","offerId":"DIGIMOBIL_ES_15-I","regions":["Western Europe"],"subTypes":["Mobile Top Up"],"priceType":"FIXED","smsNumber":0,"shortNotes":"","productType":"TOPUP","durationDays":0,"smsUnlimited":false,"voiceMinutes":0,"dataUnlimited":false,"voiceUnlimited":false},{"brand":"Digimobil","notes":"","price":{"fx":0.830565,"fee":0,"fixed":602,"margin":0.04318937,"currency":"USD","suggestedFixed":602,"currencyDivisor":100},"dataGB":0,"country":"ES","offerId":"DIGIMOBIL_ES_7.5-I","regions":["Western Europe"],"subTypes":["Mobile Top Up"],"priceType":"FIXED","smsNumber":0,"shortNotes":"","productType":"TOPUP","durationDays":0,"smsUnlimited":false,"voiceMinutes":0,"dataUnlimited":false,"voiceUnlimited":false},{"brand":"Lebara","notes":"","price":{"fx":0.829876,"fee":0,"fixed":1205,"margin":0.04481328,"currency":"USD","suggestedFixed":1205,"currencyDivisor":100},"dataGB":0,"country":"ES","offerId":"LEBARA_ES_15-I","regions":["Western Europe"],"subTypes":["Mobile Top Up"],"priceType":"FIXED","smsNumber":0,"shortNotes":"","productType":"TOPUP","durationDays":0,"smsUnlimited":false,"voiceMinutes":0,"dataUnlimited":false,"voiceUnlimited":false},{"brand":"Lebara","notes":"","price":{"fx":0.830565,"fee":0,"fixed":602,"margin":0.04318937,"currency":"USD","suggestedFixed":602,"currencyDivisor":100},"dataGB":0,"country":"ES","offerId":"LEBARA_ES_7.5-I","regions":["Western Europe"],"subTypes":["Mobile Top Up"],"priceType":"FIXED","smsNumber":0,"shortNotes":"","productType":"TOPUP","durationDays":0,"smsUnlimited":false,"voiceMinutes":0,"dataUnlimited":false,"voiceUnlimited":false},{"brand":"LlamaYa","notes":"","price":{"fx":0.829876,"fee":0,"fixed":1205,"margin":0.04481328,"currency":"USD","suggestedFixed":1205,"currencyDivisor":100},"dataGB":0,"country":"ES","offerId":"LLAMAYA_ES_15-I","regions":["Western Europe"],"subTypes":["Mobile Top Up"],"priceType":"FIXED","smsNumber":0,"shortNotes":"","productType":"TOPUP","durationDays":0,"smsUnlimited":false,"voiceMinutes":0,"dataUnlimited":false,"voiceUnlimited":false},{"brand":"LlamaYa","notes":"","price":{"fx":0.830565,"fee":0,"fixed":602,"margin":0.04318937,"currency":"USD","suggestedFixed":602,"currencyDivisor":100},"dataGB":0,"country":"ES","offerId":"LLAMAYA_ES_7.5-I","regions":["Western Europe"],"subTypes":["Mobile Top Up"],"priceType":"FIXED","smsNumber":0,"shortNotes":"","productType":"TOPUP","durationDays":0,"smsUnlimited":false,"voiceMinutes":0,"dataUnlimited":false,"voiceUnlimited":false},{"brand":"Movistar","notes":"","price":{"fx":0.829876,"fee":0,"fixed":1205,"margin":0.01742739,"currency":"USD","suggestedFixed":1205,"currencyDivisor":100},"dataGB":0,"country":"ES","offerId":"MOVISTAR_ES_15-I","regions":["Western Europe"],"subTypes":["Mobile Top Up"],"priceType":"FIXED","smsNumber":0,"shortNotes":"","productType":"TOPUP","durationDays":0,"smsUnlimited":false,"voiceMinutes":0,"dataUnlimited":false,"voiceUnlimited":false},{"brand":"Movistar","notes":"","price":{"fx":0.830105,"fee":0,"fixed":1807,"margin":0.0166021,"currency":"USD","suggestedFixed":1807,"currencyDivisor":100},"dataGB":0,"country":"ES","offerId":"MOVISTAR_ES_25-I","regions":["Western Europe"],"subTypes":["Mobile Top Up"],"priceType":"FIXED","smsNumber":0,"shortNotes":"","productType":"TOPUP","durationDays":0,"smsUnlimited":false,"voiceMinutes":0,"dataUnlimited":false,"voiceUnlimited":false},{"brand":"Movistar","notes":"","price":{"fx":0.830565,"fee":0,"fixed":602,"margin":0.01495017,"currency":"USD","suggestedFixed":602,"currencyDivisor":100},"dataGB":0,"country":"ES","offerId":"MOVISTAR_ES_7.5-I","regions":["Western Europe"],"subTypes":["Mobile Top Up"],"priceType":"FIXED","smsNumber":0,"shortNotes":"","productType":"TOPUP","durationDays":0,"smsUnlimited":false,"voiceMinutes":0,"dataUnlimited":false,"voiceUnlimited":false},{"brand":"Orange","notes":"","price":{"fx":0.829876,"fee":0,"fixed":1205,"margin":0.0340249,"currency":"USD","suggestedFixed":1205,"currencyDivisor":100},"dataGB":0,"country":"ES","offerId":"ORANGE_ES_15-I","regions":["Western Europe"],"subTypes":["Mobile Top Up"],"priceType":"FIXED","smsNumber":0,"shortNotes":"","productType":"TOPUP","durationDays":0,"smsUnlimited":false,"voiceMinutes":0,"dataUnlimited":false,"voiceUnlimited":false}],"limit":10,"total":46,"offset":0}},"exampleRequest":{"limit":10,"offset":0,"country":"ES"},"tags":["x402"],"displayCostAmount":"0.002","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.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_8wd9plPMWRlMMFmZvSp8W","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a paginated catalog of prepaid mobile top-up and bundle offers with carrier brands, country availability, voice/SMS/data allowances, and pricing details.","exampleAgentPrompt":"Show me all available prepaid mobile top-up and bundle offers for Spain — I want to see the carrier brands, data allowances, and prices for each plan.","exampleUseCases":null,"resultDescription":"A list of mobile top-up and bundle offer objects, each containing: offer ID, brand name, country (ISO code), region, product type (TOPUP or bundle), price (fixed amount, currency, FX rate, margin), data in GB (or unlimited flag), SMS count, voice minutes, duration in days, and sub-type labels (e.g. 'Mobile Top Up', 'Mobile Bundle').","failureModes":["Invalid country ISO code returns empty result set or 400 error","Invalid operator name returns empty list","Pagination offset beyond available records returns empty list","Service temporarily unavailable on Render free tier (cold start delay or downtime)","Payment failure (x402 protocol) prevents catalog retrieval"],"whenToPreferThis":"Use this endpoint when you need to discover and browse prepaid mobile top-up and bundle offers across international carriers, filtered by country or operator. Prefer this over gift card or eSIM endpoints when the user specifically wants voice/SMS/data recharge plans for a mobile number rather than travel eSIMs or retail vouchers.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:32:02.279Z","isFirstParty":false}