{"uid":"cap_ZgsrybPL8rJzZ1PS5fzds","slug":"bitrefill-topups-search-d89e1924","name":"Bitrefill Topups Search","description":"Search mobile top-ups & prepaid airtime for carriers in 180+ countries. Pay in USDC via x402, no account.","url":"https://api.bitrefill.com/x402/topups/search","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":{"q":{"type":"string","description":"Search query (carrier or operator name)"},"country":{"type":"string","description":"Optional ISO 3166-1 alpha-2 country code filter; omit for all countries (global results)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"products":[{"name":"Vodafone","slug":"vodafone-gb","country":"GB","in_stock":true,"recipient_type":"phone_number"}],"next_step":{"url":"/x402/products/detail","body":{"slug":"<product slug from results>"}}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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_sFaIIh8gzzGnMC1lhcq4S","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":"Search for mobile top-up carriers and operators by name or country on the Bitrefill platform","exampleAgentPrompt":"Search Bitrefill for mobile top-up carriers available in Mexico — show me all operators I can recharge there.","exampleUseCases":null,"resultDescription":"A list of matching mobile carriers and operators available for top-up on Bitrefill, filtered by the provided search query and/or country code, including carrier names and relevant metadata needed to proceed with a purchase.","failureModes":["No results returned if search query doesn't match any known carrier","Invalid country code returns empty or error response","Missing required 'input' wrapper causes schema validation failure","Overly broad query returns too many results to be actionable","Payment of $0.002 USDC fails due to insufficient balance, blocking the request"],"whenToPreferThis":"Use this endpoint when you need to discover which mobile carriers or telecom operators are available for top-up on Bitrefill, especially before initiating a recharge transaction. Ideal for agents that need to resolve a carrier name or validate operator availability in a specific country before purchasing mobile credit with cryptocurrency.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:33:29.920Z","isFirstParty":false}