Get Product Price for Term Length (v4)

curl -X POST https://api.megaport.com/v4/pricebook/product/terms \
     -H "Content-Type: application/json" \
     -d '{
  "currency": "AUD",
  "locationId": 123,
  "mveLabel": "MVE 16/64",
  "productType": "MVE",
  "productUid": "8afe49da-e936-4e2d-a1dd-03e2c6525108",
  "size": "large",
  "term": 12,
  "vendor": "cisco"
}'

{
  "data": {
    "1": {
      "currency": "AUD",
      "discounts": [
        {
          "amount": 0,
          "discountDetails": {
            "code": null,
            "description": null,
            "mechanism": null,
            "percentageAmount": null
          },
          "discountReason": "TERM"
        }
      ],
      "monthlyRackRate": 1063.64,
      "monthlyRate": 1063.64,
      "prices": [],
      "productType": "MCR2"
    },
    "12": {
      "currency": "AUD",
      "discounts": [
        {
          "amount": 177.27,
          "discountDetails": {
            "code": null,
            "description": null,
            "mechanism": null,
            "percentageAmount": null
          },
          "discountReason": "TERM"
        }
      ],
      "monthlyRackRate": 1063.64,
      "monthlyRate": 886.37,
      "prices": [],
      "productType": "MCR2"
    },
    "24": {
      "currency": "AUD",
      "discounts": [
        {
          "amount": 221.59,
          "discountDetails": {
            "code": null,
            "description": null,
            "mechanism": null,
            "percentageAmount": null
          },
          "discountReason": "TERM"
        }
      ],
      "monthlyRackRate": 1063.64,
      "monthlyRate": 842.05,
      "prices": [],
      "productType": "MCR2"
    },
    "36": {
      "currency": "AUD",
      "discounts": [
        {
          "amount": 265.91,
          "discountDetails": {
            "code": null,
            "description": null,
            "mechanism": null,
            "percentageAmount": null
          },
          "discountReason": "TERM"
        }
      ],
      "monthlyRackRate": 1063.64,
      "monthlyRate": 797.73,
      "prices": [],
      "productType": "MCR2"
    }
  },
  "message": "Prices for all terms",
  "terms": "This data is subject to the Acceptable Use Policy https://www.megaport.com/legal/acceptable-use-policy"
}

Returns the pricing information of all available term lengths (available term discounts) for the Megaport service specified by the productUid.

When ordering services, customers can commit to a number of fixed term lengths. Fixed terms will offer discounted monthly pricing when compared to standard ‘rack rates’, with longer terms offering larger discounts.

You can return pricing for these services:

Port
VXC
Megaport Internet
MCR
MVE

The request will be rejected if the product type is not supported.

The configurations of add-ons can be passed as part of the request Body and the add-on pricing will be included in the response.

The parameters are defined in the Body of the request:

productType - The type of product for the pricing request. Valid values include: MEGAPORT, VXC, MCR2, MVE, IX, IP_ADDRESS (String).
currency - The ISO 4217 currency code to use for pricing. For example, the US dollar is USD. If not provided, defaults to the existing product’s currency. If the product is not specified, currency must be provided. For more information, see Country Currency Codes. (String)
LocationId (Port/MCR/MVE) - The id of the location where the service will be deployed (Required - Integer).
Vendor (MVE) - The provider name to use in the price calculations. For example, Cisco (String).
Size (MVE) - The MVE size to use in price calculations. If both size and mveLabel are supplied, the endpoint will only accept mveLabel as the MVE size (String).
mveLabel (MVE) - The size of the VM. The size defines the MVE specifications, including the number of cores, bandwidth, and number of connections (String).
aLocationId (VXC) - The id of the A-End location of the VXC (Required - Integer).
bLocationId - (VXC) - The id of the B-End location of the VXC (Required - Integer).
speed - The service speed in Mbps (Integer).
aEndProductType (VXC) - The product type of the A-End service of the VXC. Valid values include: MEGAPORT, VXC, MCR2, MVE, IX, IP_ADDRESS (String).
connectType (VXC) - The connect type of the VXC, which is typically the same as the connect type of the B-End service. Valid values include: MVE, AMSIX, AWS (for Hosted VIF), AWSHC (for Hosted Connection), AZURE, GOOGLE, ORACLE, OUTSCALE, ALIBABA, and IBM. Use connectType=TRANSIT for Ports that support a Megaport Internet connection. Use connectType=FRANCEIX for Ports that you can create a VXC to in order to connect to France-IX (String).
productUid - The unique identifier for the product (String).
term - The contract term in months (Integer).
addOns - List of add-on price book requests (Array).

Query parameters

companyIdstringOptional

The Id of the company that will own the product. If not provided, it will default to the authenticated user’s company. This can be supplied with productUid to fetch the pricing of an existing product, but in the context of another company. (Optional - integer <int32> >= 1)

Request

This endpoint expects an object.

currencystringOptional

locationIddoubleOptional

mveLabelstringOptional

productTypestringOptional

productUidstringOptional

sizestringOptional

termdoubleOptional

vendorstringOptional

Response

Get Product Price for Term Length (v4) - Port / Get Product Price for Term Length (v4) - VXC / Get Product Price for Term Length (v4) - MCR / Get Product Price for Term Length (v4) - MVE / Get Product Price for Term Length (v4) - VXC / Get Product Price for Term Length (v4) - Port / Get Product Price for Term Length (v4) - MCR / Get Product Price for Term Length (v4) - MVE

dataobjectOptional

messagestringOptional

termsstringOptional