Enterprise REST API v1

ConnectMeGuru B2B Wholesale API

Integrate global eSIM ordering, two-step top-ups, usage monitoring, and crypto funding into your app.

📥OpenAPI 3.1 Spec

Core Integration Details

API Base URLhttps://connectmeguru.com/api/b2b/v1

Partner Portal UIhttps://partner.connectmeguru.com

Currency & SettlementUSD (USDT / USDC)

Authentication: Pass your two API headers with every request:

X-B2B-Key: cmg_live_YOUR_KEY_HERE

X-B2B-Secret: cmg_sec_YOUR_SECRET_HERE

Generate and manage your keys anytime from the API Keys tab in the portal.

GET/api/b2b/v1/balance

Get Account Balance

Returns your current prepaid USD wallet balance and account status.

Response 200 OK

{
  "success": true,
  "companyName": "Acme Corp",
  "currency": "USD",
  "balanceUsd": 250.00,
  "lowBalanceThreshold": 50.00,
  "isLowBalance": false,
  "status": "ACTIVE"
}

Example cURL

curl -X GET "https://connectmeguru.com/api/b2b/v1/balance" \
  -H "X-B2B-Key: cmg_live_demo_key_abc123" \
  -H "X-B2B-Secret: cmg_sec_demo_secret_xyz789"

POST/api/b2b/v1/balance/deposit

Generate Crypto Deposit Address

Generates a multi-chain deposit address (USDT or USDC) to fund your USD balance.

Parameters

Field	Type	Location	Required	Description
amountUsd	number	body	Yes	Deposit amount in USD (minimum $10)
currency	string	body	Yes	Stablecoin: "USDT" or "USDC"
network	string	body	No	"BASE", "POLYGON", "ARBITRUM", or "TRON" (default: BASE)

Request JSON Body

{
  "amountUsd": 100,
  "currency": "USDT",
  "network": "BASE"
}

Response 200 OK

{
  "success": true,
  "invoiceId": "inv_demo_849201",
  "amountUsd": 100,
  "currency": "USDT",
  "network": "BASE",
  "depositAddress": "0x71C...aB49",
  "checkoutUrl": "https://crypto.connectmeguru.com/checkout/inv_demo_849201"
}

Example cURL

curl -X POST "https://connectmeguru.com/api/b2b/v1/balance/deposit" \
  -H "Content-Type: application/json" \
  -H "X-B2B-Key: cmg_live_demo_key_abc123" \
  -H "X-B2B-Secret: cmg_sec_demo_secret_xyz789" \
  -d '{"amountUsd": 100, "currency": "USDT", "network": "BASE"}'

GET/api/b2b/v1/plans

Browse Wholesale eSIM Plans

Retrieve real-time available eSIM data packages with direct wholesale purchase prices in USD.

Parameters

Field	Type	Location	Required	Description
country	string	query	No	2-letter ISO country code (e.g. "US", "JP", "GB")
type	string	query	No	"BASE" for new eSIMs or "TOPUP" (default: BASE)
query	string	query	No	Optional search keyword (e.g. "Europe", "Unlimited")

Response 200 OK

{
  "success": true,
  "currency": "USD",
  "total": 1,
  "plans": [
    {
      "packageCode": "US_1GB_7D",
      "name": "United States 1GB 7 Days",
      "locationCodes": ["US"],
      "dataAmountGb": 1.0,
      "durationDays": 7,
      "priceUsd": 1.45,
      "planType": "BASE",
      "operator": "Verizon / AT&T"
    }
  ]
}

Example cURL

curl -X GET "https://connectmeguru.com/api/b2b/v1/plans?country=US" \
  -H "X-B2B-Key: cmg_live_demo_key_abc123" \
  -H "X-B2B-Secret: cmg_sec_demo_secret_xyz789"

POST/api/b2b/v1/orders

Order & Provision Instant eSIM

Purchases an eSIM using your prepaid USD wallet. Returns instant activation credentials (QR code URL, LPA string, ICCID).

Parameters

Field	Type	Location	Required	Description
packageCode	string	body	Yes	Package identifier obtained from /api/b2b/v1/plans
partnerRefId	string	body	No	Your internal order ID (used for idempotency & reconciliation)

Request JSON Body

{
  "packageCode": "US_1GB_7D",
  "partnerRefId": "order_ref_12345"
}

Response 200 OK

{
  "success": true,
  "balanceRemainingUsd": 248.55,
  "order": {
    "id": "cmg_ord_90184",
    "partnerRefId": "order_ref_12345",
    "orderNo": "E2610080001",
    "iccid": "89852000000000000000",
    "packageCode": "US_1GB_7D",
    "planName": "United States 1GB 7 Days",
    "chargedUsd": 1.45,
    "qrCodeUrl": "https://api.esimaccess.com/qr/E2610080001.png",
    "smdpAddress": "rsp.truphone.com",
    "matchingId": "MATCH-CODE-123",
    "lpaString": "LPA:1$rsp.truphone.com$MATCH-CODE-123",
    "createdAt": "2026-10-08T12:00:00Z"
  }
}

Example cURL

curl -X POST "https://connectmeguru.com/api/b2b/v1/orders" \
  -H "Content-Type: application/json" \
  -H "X-B2B-Key: cmg_live_demo_key_abc123" \
  -H "X-B2B-Secret: cmg_sec_demo_secret_xyz789" \
  -d '{"packageCode": "US_1GB_7D", "partnerRefId": "order_ref_12345"}'

GET/api/b2b/v1/orders/{iccid}/topup-plans

1. Discover Compatible Top-Up Bundles

First step in the top-up flow: Pass an active ICCID to check which carrier bundles are eligible for recharge.

Parameters

Field	Type	Location	Required	Description
iccid	string	path	Yes	The 19-20 digit ICCID of the active eSIM

Response 200 OK

{
  "success": true,
  "iccid": "89852000000000000000",
  "currency": "USD",
  "plans": [
    {
      "packageCode": "US_TOPUP_1GB_7D",
      "name": "United States Top-up 1GB 7 Days",
      "dataAmountGb": 1.0,
      "durationDays": 7,
      "priceUsd": 1.40,
      "planType": "TOPUP"
    }
  ]
}

Example cURL

curl -X GET "https://connectmeguru.com/api/b2b/v1/orders/89852000000000000000/topup-plans" \
  -H "X-B2B-Key: cmg_live_demo_key_abc123" \
  -H "X-B2B-Secret: cmg_sec_demo_secret_xyz789"

POST/api/b2b/v1/orders/{iccid}/topup

2. Execute Instant Top-Up

Second step in the top-up flow: Applies the selected bundle directly to the active eSIM profile.

Parameters

Field	Type	Location	Required	Description
iccid	string	path	Yes	The 19-20 digit ICCID of the active eSIM
packageCode	string	body	Yes	The top-up package code chosen from step 1
partnerRefId	string	body	No	Your internal transaction ID

Request JSON Body

{
  "packageCode": "US_TOPUP_1GB_7D",
  "partnerRefId": "topup_ref_67890"
}

Response 200 OK

{
  "success": true,
  "message": "Top-up applied successfully to eSIM 89852000000000000000",
  "balanceRemainingUsd": 247.15,
  "topUpOrder": {
    "id": "cmg_topup_48102",
    "iccid": "89852000000000000000",
    "packageCode": "US_TOPUP_1GB_7D",
    "chargedUsd": 1.40,
    "createdAt": "2026-10-08T12:05:00Z"
  }
}

Example cURL

curl -X POST "https://connectmeguru.com/api/b2b/v1/orders/89852000000000000000/topup" \
  -H "Content-Type: application/json" \
  -H "X-B2B-Key: cmg_live_demo_key_abc123" \
  -H "X-B2B-Secret: cmg_sec_demo_secret_xyz789" \
  -d '{"packageCode": "US_TOPUP_1GB_7D", "partnerRefId": "topup_ref_67890"}'

GET/api/b2b/v1/orders/{iccid}/usage

Check Real-Time Data Usage

Fetches real-time carrier telemetry for an active eSIM: total data, consumed data, remaining data, and profile status.

Parameters

Field	Type	Location	Required	Description
iccid	string	path	Yes	The 19-20 digit ICCID of the eSIM

Response 200 OK

{
  "success": true,
  "iccid": "89852000000000000000",
  "status": "ACTIVE",
  "totalGb": 1.0,
  "usedGb": 0.35,
  "remainingGb": 0.65,
  "percentUsed": 35
}

Example cURL

curl -X GET "https://connectmeguru.com/api/b2b/v1/orders/89852000000000000000/usage" \
  -H "X-B2B-Key: cmg_live_demo_key_abc123" \
  -H "X-B2B-Secret: cmg_sec_demo_secret_xyz789"