REST API v1.0 • Live & Automated

REST API Reference

The ViaConecta B2B API enables automated eSIM provisioning, real-time wholesale catalog lookups, account balance telemetry, and order tracking across 130+ countries.

# 1. Overview # 2. Authentication # 3. Account /me # 4. Plans Catalog # 5. Orders # 6. Analytics Feed # 7. Errors

1. Overview & Base URL

All requests must be made over secure HTTPS. All request bodies and responses use standard JSON format with UTF-8 encoding.

Production Base URL

HTTPS https://b2b.viaconecta.co/api/v1

v1.0 Active

Data Format

JSON (application/json)

Authentication

Bearer API Key

Rate Limits

60 req / min (Per Key)

2. Authentication

Authenticate all API requests by passing your secret API key in the Authorization header as a Bearer token:

curl -X GET https://b2b.viaconecta.co/api/v1/me \
  -H "Authorization: Bearer vc_live_YOUR_SECRET_API_KEY" \
  -H "Accept: application/json"

🔒 Security Notice: Never expose your API keys in client-side code, mobile binaries, or public GitHub repositories. Always call the ViaConecta API from your backend servers.

3. Partner Profile & Tier

GET /api/v1/me

Returns authenticated partner profile information, active partner tier discount, and tracking referral code.

Sample 200 OK Response

{
  "success": true,
  "account": {
    "id": 2,
    "name": "Acme Travel Group",
    "email": "[email protected]",
    "company_name": "Acme Travel S.L.",
    "tier": "platinum",
    "tier_label": "💎 Platinum Partner",
    "tier_discount_percent": 20,
    "referral_code": "ACMTRVL",
    "referral_commission_rate": "15%",
    "status": "active",
    "created_at": "2026-08-20T10:00:00.000000Z"
  }
}

4. Wholesale Plans & Pricing

GET /api/v1/plans

Returns authentic ViaConecta retail catalog plans with partner rates calculated dynamically based on your tier.

Sample 200 OK Response

{
  "success": true,
  "partner_tier": "gold",
  "partner_discount_percent": 15,
  "count": 1122,
  "data": [
    {
      "id": "Spain_5_GB_15_Days",
      "name": "Spain 5 GB (15 Days)",
      "country_or_region": "Spain",
      "data_allowance": "5 GB",
      "data_gb": 5,
      "duration_days": 15,
      "type": "fixed",
      "retail_price": 7.90,
      "partner_price": 6.72,
      "currency": "EUR",
      "speed": "4G/5G LTE",
      "tethering": true
    },
    {
      "id": "Balkans_5_GB_15_Days",
      "name": "Balkans 5 GB (15 Days)",
      "country_or_region": "Balkans",
      "data_allowance": "5 GB",
      "data_gb": 5,
      "duration_days": 15,
      "type": "fixed",
      "retail_price": 11.90,
      "partner_price": 10.12,
      "currency": "EUR",
      "speed": "4G/5G LTE",
      "tethering": true
    }
  ]
}

5. Order Tracking & Fulfillment

Orders are fulfilled securely via the authenticated B2B portal or co-branded partner referral checkout links with instant automated QR delivery to the customer. Direct programmatic raw issuance is reserved for bespoke enterprise SLA contracts.

INFO Order Creation Workflow

To ensure telecommunications licensing compliance and eliminate carrier fraud risk, B2B partners issue customer eSIMs via the portal at b2b.viaconecta.co/orders or by sharing direct co-branded affiliate links.

GET /api/v1/orders

Query paginated order history with support for ?limit=50.

6. Affiliate & Campaign Analytics

Affiliate Feed

Automated REST API feed for partner dashboards and comparison platforms. Query real-time clicks, user signups, conversions, gross sales volume, commission balances, and timeframe daily breakdowns.

GET /api/v1/affiliate/analytics

Query campaign metrics with optional date filters (defaults to the last 30 days).

Optional Query Parameters

start_date YYYY-MM-DD (e.g. 2026-09-01)

end_date YYYY-MM-DD (e.g. 2026-09-17)

curl -X GET "https://b2b.viaconecta.co/api/v1/affiliate/analytics?start_date=2026-09-01&end_date=2026-09-17" \
     -H "X-API-Key: vc_live_YOUR_API_KEY"

Sample 200 OK Response

{
  "success": true,
  "partner": "WaviSIM Team",
  "referral_code": "WAVISIM10",
  "campaign_links": [
    "https://viaconecta.co/?ref=WAVISIM10",
    "https://viaconecta.co/?ref=wavisim"
  ],
  "period": {
    "start_date": "2026-09-01",
    "end_date": "2026-09-17",
    "days": 17
  },
  "summary": {
    "clicks": 14,
    "signups": 0,
    "conversions": 0,
    "conversion_rate": "0.00%",
    "currency": "EUR",
    "gross_sales": 0.00,
    "commission_rate": "10%",
    "commission_earned": 0.00,
    "all_time_totals": {
      "total_clicks": 14,
      "total_signups": 0,
      "commission_total": 0.00,
      "commission_pending": 0.00,
      "commission_paid": 0.00
    }
  },
  "daily_breakdown": [
    {
      "date": "2026-09-16",
      "clicks": 2,
      "conversions": 0,
      "gross_sales": 0.00,
      "commission": 0.00
    }
  ]
}

7. Standard Error Codes

HTTP Code	Error	Meaning
200 / 201	Success	Request succeeded, profile provisioned.
401	Unauthorized	Missing or invalid Bearer API key.
403	Forbidden	Account is pending verification or deactivated.
422	Validation Error	Invalid plan_id or payload parameters.
429	Too Many Requests	Rate limit exceeded (>60 req/min). Throttle requests.

Ready to Integrate?

Generate your live credentials in partner settings and begin provisioning eSIMs immediately.

Create Partner Account →