Retrieves available eSIM data plans for a specific region or country. This endpoint returns detailed product information including pricing, data volumes, validity periods, and technical specifications for eSIM activation.

Purpose

• Browse available data plans for specific countries or regions
• Get pricing information for different data volumes
• Check plan validity periods and renewal options
• Retrieve product SKUs for ordering

Request

• Method: POST
• URL: https://api.bnesim.com/v2.0/enterprise/products/get-products
• Content-Type: multipart/form-data
• Authentication: Bearer token required

Parameters

• area (Optional): ISO2 country code or region identifier
  • Use country codes from the regions endpoint (e.g., "AE" for UAE, "US" for USA)
  • Use region identifiers for multi-country plans (e.g., "Europe", "Asia", "Global")
  • If omitted, returns all available products

Response Fields

• success: Boolean indicating request success
• products: Array of available products containing:
  • id: Unique product identifier
  • name: Human-readable product name
  • price: Price in the default currency
  • volume: Data volume in MB (1024 = 1GB)
  • duration: Validity period in days. Note: 180 is a special value meaning no expiration, not 180 days
  • region_names: Coverage area description
  • sku: Stock keeping unit for ordering
  • type: Product type (e.g., "LOCAL_TOPUP_DATA")
  • validity_label: Human-readable validity description
  • currency_postfix_label: Pricing period indicator (e.g., "/month")
  • full_price: Original price before discounts
  • activation_type: How the product is activated ("API")
  • imsi_id: Technical identifier for eSIM provisioning

Product Types

1. No Expiration Plans: duration: 180 - special encoding meaning the plan never expires (it does NOT mean 180 days / 6 months)
2. Monthly Plans: duration: 30 - Data valid for 30 days
3. Daily Plans: duration: 1 - Data refreshes daily

Pricing Notes

• Prices are in the account's default currency
• full_price shows original price when discounted
• Monthly plans may show both one-time and recurring prices

Example cURL

curl --request POST \
     --url https://api.bnesim.com/v2.0/enterprise/products/get-products \
     --header "accept: application/json" \
     --header "authorization: Bearer {{bearerToken}}" \
     --header "content-type: multipart/form-data" \
     --form area=AE

Usage Tips

• Filter by specific country for local plans
• Use region identifiers for travelers needing multi-country coverage
• Check validity_label to understand plan expiration
• Compare duration values to choose between prepaid and recurring plans
• Use the sku field when placing orders through the activation API