ConnectMeGuru Developer Integration Guide

Base: https://partner.connectmeguru.com
Architectural Notice • Deprecation WarningStandardizing on Universal SIM Profile ID

Future Deprecation of ICCID — Please Use simProfileId Going Forward

ConnectMeGuru is transitioning to simProfileId (e.g. AA89972502300011036) as the universal primary identifier across all carriers and APIs. While legacy iccid currently continues to function for backward compatibility, ICCID will be deprecated in a future API release. All B2B partners and integrations should store and query using simProfileId for Order Queries, Usage Telemetry, Top-Ups, Cancellations, and Webhook listeners.

Documentation Index
Authentication

API Key Authentication & Base URLs

Every request to the ConnectMeGuru Wholesale API must be authenticated using your API Key and Secret passed as custom HTTP headers.

Header: X-B2B-Key

Your public API key identifier (starts with cmg_live_...).

Header: X-B2B-Secret

Your confidential API secret key (starts with cmg_sec_...). Never expose this in client-side code!

1. Universal Request Headers (Mandatory on All Endpoints)
ParameterInTypeRequiredDescription
X-B2B-KeyHeaderstringRequiredYour public API Key identifier (e.g. cmg_live_b541f892...).
X-B2B-SecretHeaderstringRequiredYour confidential API Secret (e.g. cmg_sec_81caa742...).
Content-TypeHeaderstringRequiredMust be "application/json" for all POST requests.
2. Sample Request
curl -X GET "https://partner.connectmeguru.com/api/b2b/v1/balance" \
  -H "X-B2B-Key: cmg_live_demo_key_abc123" \
  -H "X-B2B-Secret: cmg_sec_demo_secret_xyz789"
3. Response Parameters
FieldTypeDescription
successbooleanTrue if authentication was verified and request succeeded.
companyNamestringRegistered trading name of the authenticated partner.
statusstringAccount status ("ACTIVE" or "SUSPENDED").
4. Sample Response (HTTP 200 OK)
{
  "success": true,
  "companyName": "Acme Global Travels",
  "status": "ACTIVE"
}
Important: Profile Identification Standards (simProfileId vs. ICCID)

ConnectMeGuru uses simProfileId as the universal primary identifier across all carriers (e.g., AA89972502300011036). Unlike carrier-specific ICCIDs that may change across top-ups or multi-IMSI handovers, simProfileId remains immutable for the lifetime of the profile.

Deprecation Schedule Notice:

ICCID will be deprecated in a future API release. Existing integrations using ICCID will remain functional during the grace period, but all partners should store simProfileId in their database and pass it to downstream endpoints (/orders/{simProfileId}, /usage, /topup, /cancel).

ConnectMeGuru B2B Wholesale eSIM Gateway | Global eSIM API for Travel & Enterprise