{"uid":"cap_alQCQMAPdZKUg8gVlWMU0","slug":"api-reloadpi-com-627ae1fd","name":"Reloadpi Voucher Search Filter Options","description":"Reloadpi — Get available filter options for voucher search including brands, countries and categories","url":"https://api.reloadpi.com/api/catalog/vouchers/filters","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","properties":{"brands":{"type":"array","items":{"type":"string"}},"countries":{"type":"array","items":{"type":"string"}},"categories":{"type":"array","items":{"type":"string"}}}}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{}}},"response":{"_truncated":true,"_originalSize":10372}},"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_qpUbtJZz-xu5TRqnbG5Sy","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 available filter options (brands, countries, categories) for searching the voucher and gift card catalog","exampleAgentPrompt":"What brands, countries, and categories can I use to filter the Reloadpi voucher catalog before searching for a gift card?","exampleUseCases":[{"title":"Build a dynamic gift card filter UI","prompt":"I'm building a shopping interface for our customers to find gift cards. Can you pull all the available brands, countries, and categories so I can populate the filter dropdowns?"},{"title":"Validate user filter choices before search","prompt":"Before I search the voucher catalog with the filters our user selected, can you fetch what brands and countries are actually supported so I can warn them if they picked something invalid?"},{"title":"Discover new voucher catalog options","prompt":"Show me everything we can filter by in the Reloadpi catalog—all the brands, supported countries, and voucher categories—so I know what gift cards are available to recommend to users."}],"resultDescription":"Returns three arrays: a list of available brand names (e.g. Amazon, Netflix, Google Play), a list of supported country codes or names, and a list of voucher categories — all usable as filter parameters when searching the voucher catalog.","failureModes":["Service unavailable — 5xx error if Reloadpi API is down","Empty arrays returned if catalog filters are temporarily unpopulated","Payment required — 402 if x402 payment header is missing or invalid","Unexpected schema changes if catalog is being updated"],"whenToPreferThis":"Use this endpoint before calling the voucher search endpoint to discover what valid filter values are available for brands, countries, and categories — avoids invalid filter errors and helps build dynamic filter UIs or agent decision trees.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:43:54.965Z","isFirstParty":false}