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
- Native eSIM Integration - The core Partner API (
core.hubbyesim.com): start here - Quickstart Guide (Legacy API) - Set up your API credentials and make your first booking
- Authentication (Legacy API) - Learn about our secure HMAC authentication system
Integration Use Cases (Legacy API)
- 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
- Classic eSIM Grants - Grant single-IMSI eSIMs that travelers set the destination for and claim from your native app
Advanced Topics
- Error Handling (Legacy API) - Best practices for handling API errors
- Package Types (Legacy API) - Understanding different eSIM package types (data-limited, unlimited, starter)
- Regional Packages (Legacy API) - Regional package codes and country coverage
- Destinationless Packages (Legacy API) - Understanding destinationless eSIM packages
- Webhooks - Real-time notifications for events like a package activation (
package.activated)
Support
Need help with your integration? Contact our support team:
- Email: support@hubbyesim.com
- Partner API 5.x (core) reference - Every operation, field and refusal of the core Partner API
- API Reference (Legacy API) - The legacy API on
api.hubbyesim.com