Hubby eSIM API Documentation
Welcome to the Hubby eSIM API documentation. Here you'll find comprehensive guides and examples to help you integrate global eSIM connectivity into your travel services.
Core Concepts
The Hubby API is built around three entities that deliberately mirror the travel industry:
| Entity | What it represents | Why it matters |
|---|---|---|
| Booking | A traveler's trip — groups one or more data packages, tied to a departure date | Maps directly to the booking you already have in your system (flight, hotel, tour). One API call, same mental model. |
| Destination | A country or region the traveler is visiting (ISO codes, names, or regional codes like EU) | The same destination concept your platform already works with — no translation layer needed. |
| Bundle | A specific data product for a destination — defines size, duration, type, and price | What the traveler actually gets. Bundles are grouped by Destination, so browsing and purchasing feels like any other travel add-on. |
We chose these names and structures so that integrating eSIM connectivity feels like adding another travel product to your platform — not like learning a telecom API.
Getting Started
- Quickstart Guide - Set up your API credentials and make your first booking
- Authentication - Learn about our secure HMAC authentication system
Integration Use Cases
- High Conversion OTA Integration - Automatic package assignment for maximum conversion
- Manual Package Selection - Let customers choose their preferred package
- Rewarding Loyalty Members - Reward loyal customers with promo codes
- Simple Booking Integration - Create bookings with destinationless starter packages
Advanced Topics
- Error Handling - Best practices for handling API errors
- Package Types - Understanding different eSIM package types (data-limited, time-limited, starter)
- Regional Packages - Regional package codes and country coverage
- Destinationless Packages - Understanding destinationless eSIM packages
- Webhooks - Real-time notifications for events like promo code redemptions
Support
Need help with your integration? Contact our support team:
- Email: support@hubbyesim.com
- API Reference - Detailed API specifications