Skip to main content
GET
/
product-offerings
/
{productOfferingId}
Get product offering
curl --request GET \
  --url https://apiv2.example.com/product-offerings/{productOfferingId} \
  --header 'X-Api-Key: <api-key>'
{
  "productOfferingId": "<string>",
  "status": "AVAILABLE",
  "name": "Seamless 10GB",
  "price": {
    "currency": "USD",
    "priceType": "ONE_TIME",
    "discount": 5,
    "netPrice": 5,
    "boundMonths": 12,
    "billingCycle": {
      "period": "MONTHLY",
      "interval": 1
    }
  },
  "customerType": "CONSUMER",
  "description": "Basic mobile plan with 5GB data and unlimited calls",
  "richContent": "<h3>Features</h3><ul><li>5GB monthly data</li><li>Unlimited calls & texts</li><li>No setup fees</li></ul>",
  "product": {
    "productId": "<string>",
    "internalName": "<string>",
    "type": "SUBSCRIPTION",
    "category": "SUBSCRIPTION_CELL",
    "networkProviderId": "tmobile-us",
    "features": {
      "dataMb": 2048,
      "includedCallSeconds": 1000,
      "includedSms": 500
    }
  },
  "group": {
    "productOfferingGroupId": "mobile-plans",
    "name": "Mobile Plans",
    "category": "SUBSCRIPTION_CELL",
    "description": "Bundled cell subscriptions with unlimited calls and SMS with ILD enabled.",
    "internalDescription": "Core mobile offerings targeting consumer and business segments"
  },
  "addonCategories": [
    "SUBSCRIPTION_CELL"
  ],
  "internalDescription": "seamless_cell_10gb_us",
  "imageUrl": "https://cdn.example.com/images/mobile-basic.png",
  "metadata": {}
}

Authorizations

​
X-Api-Key
string
header
required

An API key that grants access to the Connect API. You can create and manage API keys in the portal.

Path Parameters

​
productOfferingId
string
required

The unique identifier of the product offering.

Query Parameters

​
promoCode
string

Apply promotional pricing by providing a valid promo code.

Response

Product offering details.

A product offering is a product combined with a price that is offered to customers.

​
productOfferingId
string
required

Unique identifier for the product offering.

​
status
enum<string>
required

The status of the product offering.

Archived offerings are not allowed to be created/ordered by customers, but can still be used for existing subscriptions.

Available options:
AVAILABLE,
ARCHIVED
Example:

"AVAILABLE"

​
name
string
required

Name of the product offering.

Example:

"Seamless 10GB"

​
price
object
required

Pricing information with discount details.

​
customerType
enum<string>
required

The type of customer.

Available options:
CONSUMER,
BUSINESS
​
description
string

Description of the product offering.

Example:

"Basic mobile plan with 5GB data and unlimited calls"

​
richContent
string

Rich HTML content with detailed information about the product offering.

Example:

"<h3>Features</h3><ul><li>5GB monthly data</li><li>Unlimited calls & texts</li><li>No setup fees</li></ul>"

​
product
object

Embedded representation of a product.

​
group
object

A product group organizes related product offerings.

​
addonCategories
string[]

List of product categories this addon is applicable for. Only populated when type is ADDON.

A product category is a sub-type for grouping offerings of the same type.

Typically, product offerings of the same type with the same category allow for switching between them. For upgrading and downgrading subscriptions and licenses, we recommend using their corresponding endpoints though.

​
internalDescription
string

Internal description of the product offering for operational use only.

Example:

"seamless_cell_10gb_us"

​
imageUrl
string<uri>

URL to the image representing the product offering.

Example:

"https://cdn.example.com/images/mobile-basic.png"

​
metadata
object

A set of key-value pairs that can be attached to an object for storing additional information in a semi-structured format.