ConnectMeGuru Developer Integration Guide
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.
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.
Your public API key identifier (starts with cmg_live_...).
Your confidential API secret key (starts with cmg_sec_...). Never expose this in client-side code!
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
| X-B2B-Key | Header | string | Required | Your public API Key identifier (e.g. cmg_live_b541f892...). |
| X-B2B-Secret | Header | string | Required | Your confidential API Secret (e.g. cmg_sec_81caa742...). |
| Content-Type | Header | string | Required | Must be "application/json" for all POST requests. |
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"
| Field | Type | Description |
|---|---|---|
| success | boolean | True if authentication was verified and request succeeded. |
| companyName | string | Registered trading name of the authenticated partner. |
| status | string | Account status ("ACTIVE" or "SUSPENDED"). |
{
"success": true,
"companyName": "Acme Global Travels",
"status": "ACTIVE"
}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.
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).
