Products
Browse and understand the Bitrefill product catalog.
Bitrefill offers three main product types: gift cards, eSIMs, and phone top-ups. This guide explains how to browse, search, and understand product data.
Product Types
| Type | Description | Examples |
|---|---|---|
| Gift Cards | Digital gift cards with redemption codes | Amazon, Steam, Netflix |
| eSIMs | Digital SIM cards with data plans | Bitrefill eSIM Europe |
| Phone Top-ups | Mobile airtime and data refills | AT&T, Vodafone, Orange |
Browsing Products
const response = await fetch(`${BASE_URL}/products?limit=50`, { headers });
const { data: products, meta } = await response.json();
products.forEach(p => console.log(`${p.id}: ${p.name} (${p.type})`));
// Pagination
if (meta._next) {
// Fetch next page
}Product Structure
Every product includes:
| Field | Description |
|---|---|
id | Unique identifier (slug) |
name | Display name |
type | Product type |
country | Target country code |
currency | Denomination currency |
in_stock | Availability status |
packages | Fixed denominations |
range | Flexible value range |
Denominations
Products offer values in two ways. See Core Concepts for detailed explanation.
Packages (Fixed Values)
Use the package_id when creating invoices.
Ranges (Flexible Values)
Specify any value within the range when creating invoices.
Product Guides
Updated about 2 months ago