{"uid":"cap_l2kqT4Z_Lc22cdiBU9AWz","slug":"stablegiftcards-buy-api-08ba72f3","name":"StableGiftCards Buy API","description":"Search and buy Bitrefill gift cards, top-ups, and eSIMs. 1,500+ brands, 180+ countries.","url":"https://stablegiftcards.dev/api/buy","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"cart_items":{"type":"array","items":{"type":"object","required":["product_id","package_id"],"properties":{"email":{"type":"string","format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"quantity":{"type":"integer","default":1,"maximum":9007199254740991,"minimum":1},"package_id":{"anyOf":[{"type":"string"},{"type":"number"}]},"product_id":{"type":"string","minLength":1},"phone_number":{"type":"string"}},"additionalProperties":false},"maxItems":15,"minItems":1}}},"responseSchema":{"type":"json","example":{}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"500","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":"$500/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"500","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"500","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_sWCVrovH7QzhiafIEVy8V","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"500","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Purchase Bitrefill gift cards, mobile top-ups, and eSIMs from 1,500+ brands across 180+ countries in a single API call","exampleAgentPrompt":"Buy me a $25 Amazon US gift card and a $10 Spotify gift card, both sent to john@example.com — I need 1 of each.","exampleUseCases":[{"title":"Equip travelers with international connectivity","prompt":"I'm flying to Japan next week and need an eSIM that works there. Can you grab one for me and have it ready before my flight?"},{"title":"Send bulk holiday gifts to team members","prompt":"I've got 12 people on my team and want to send each of them a $50 gift card to their choice of Amazon or Apple. Can you handle that and send them to their work emails?"},{"title":"Instant mobile top-up for family abroad","prompt":"My cousin in Brazil just texted that her phone is about to die. Can you buy her a mobile top-up credit right now and send her the details?"}],"resultDescription":"Returns a JSON object confirming the purchase, including order details for each cart item such as gift card codes, redemption instructions, top-up confirmation, or eSIM activation details depending on the product type purchased.","failureModes":["Invalid product_id or package_id returns an error indicating the product or package does not exist","Missing required cart_items array returns a validation error","Email format invalid for products requiring delivery returns a format validation error","Phone number missing or malformed for top-up products results in an error","Cart exceeds 15 items maximum and is rejected","Payment of $500 USDC not fulfilled via x402 protocol results in payment failure","Out-of-stock or unavailable product returns an availability error","Quantity below 1 or non-integer value fails schema validation"],"whenToPreferThis":"Choose this endpoint when an agent needs to programmatically purchase digital gift cards, mobile top-ups, or eSIMs from a large catalog of global brands (1,500+, 180+ countries) via Bitrefill in a single transactional POST call, especially when automation, bulk purchasing (up to 15 items per cart), or international coverage is required. Best suited for agents handling gifting workflows, travel prep (eSIMs), or telecom top-ups.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:30:21.125Z","isFirstParty":false}