> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://en.megaport.ferndocs.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://en.megaport.ferndocs.com/_mcp/server.

# Release Notes

## New Endpoint for IPsec Data

**New Endpoint for IPsec Data** – A new endpoint `GET /v3/products/mcrs/{productUid}/ipsec` has been created to retrieve IPsec-related data. The endpoint response Body includes the following:

* Max IPsec tunnel count limit for the MCR.
* Total tunnel count - total number of configured tunnels for an MCR.
* The list of IPsec configured tunnels with details, including:
  * VXC name
  * VXC product Uid
  * VLAN
  * IPsec tunnels (sourceIpAddress, destinationIpAddress, description)

## Employee Invitation Status Visibility

**invitationPending field added to /v2/employee** – Added the `invitationPending` field to the `GET /v2/employee` endpoint response to improve employee invitation status visibility.

## Cross Connect Ordering and Partner Resource Limits

**Cross Connect Ordering** – In the networkdesign/validate and networkdesign/buy endpoints, the Cross Connect implementation has been updated to use the `addOn` config instead of the `crossConnectRequested` flag.

**Partner Resource Limits** – Megaport partners can now configure resource limits for their managed companies via the API. The POST and PUT `/v2/managedCompanies` endpoints now accept a new optional field in the request Body called `resourceLimits`.

Example structure:

**`JSON`**

```json JSON
{  
...  
"resourceLimits": [  
{  
"productType": "MEGAPORT",  
"limit": 10  
},  
{  
"productType": "VXC",  
"limit": 20  
}  
],  
...  
}
```

## MVE Images and Service Speed Values

**Changes for GET /v4/product/mve/images** – These changes have been made to the response Body of this endpoint:

* A new field `vendorProductId` has been added. This is a unique identifier generated by concatenating the `product` and `vendor` values.
* MVE images are now returned with the most recent (highest id) being returned first, per product and vendor.

**Service Speed Values in GET /v3/locations** – The `mcrSpeedMps` and `megaportSpeedMbps` array values in the `/v3/locations` endpoint response are now returned in ascending order.

## Locations API v3 and Invoice APIs Updated

**GET /v3/locations** – The Megaport Portal has been updated to use the new `/v3/locations` API endpoint instead of `/v2/locations`. The `/v2/locations` public API is now deprecated and will be fully decommissioned on 31 July 2025. For more information, see [API Deprecation Notices and Frequently Asked Questions (FAQs)](/api-reference).

**Invoice APIs Updated to V3** – The Megaport Portal has been updated to use the new v3 invoice API endpoints instead of v2. Note also that `companyId` has been updated to `companyUid`, and `supplierId` has been added to the URL in the v3 version. The v2 public APIs are now deprecated and will be fully decommissioned on 31 July 2025. For more information, see [API Deprecation Notices and Frequently Asked Questions (FAQs)](/api-reference).

**Disallow Service Deletion when Connected VXCs Exist** – Previously, deleting a product in the Megaport Terraform Provider, either explicitly or due to Port speed changes, could inadvertently delete attached VXCs. This caused an issue as the Megaport Terraform Provider was unaware of the deletion, which led to unexpected results. Therefore, a query parameter `safe_delete=true` has been added to delete calls in the Megaport Terraform Provider, which tells the API to return an error when deleting a product if it has attached VXCs. This makes it clear to the user that they need to move the VXC first, or delete it independently of their current operation, without causing issues to the Terraform state. This does not affect existing API or Portal users.

## Jumbo Frame Support and Packet Filtering

**Jumbo Frame Support on MCR** – A new field `ipMtu` has been added to the following endpoints which allows you to set the largest size (in bytes) of an IP packet that can be sent over the connected VXC.

* `POST /v3/networkdesign/validate`
* `POST /v3/networkdesign/buy`
* `PUT /v3/product/vxc/{uid}`

**Invoice Endpoint Improvements** – The invoicing endpoints have been updated to change the Invoice Charge From/To date fields to reflect the time period to which the ETF applies - the ETF duration.

**Packet Filtering on MCR Endpoints** – New endpoints have been created to manage MCR packet filters via the API. New fields have also been added to the VXC create/update endpoint data within the interfaces object to define packet filters for a VXC (`packetFilterIn`/`packetFilterOut`).

* `GET /v2/product/mcr2/{productUid}/packetFilter/{packetFilterId}` – MCR Packet Filter Details
* `GET /v2/product/mcr2/{productUid}/packetFilters` – MCR Packet Filter Summary List
* `POST /v2/product/mcr2/{productUid}/packetFilter` – Create MCR Packet Filter
* `PUT /v2/product/mcr2/{productUid}/packetFilter/{packetFilterId}` – Update MCR Packet Filter
* `DEL /v2/product/mcr2/{productUid}/packetFilter/{packetFilterId}` – Delete MCR Packet Filter

**Fixed** – The `/v2/products` endpoint was taking up to 4 minutes to respond for Google inc. This has now reduced significantly to around 50 seconds.

## GET /v3/locations Improvements

**Updated GET /v3/locations** – These improvements have been made to the `/v3/locations` endpoint:

* Added the optional parameter `mveImageId`. When including the mveImageId, the endpoint will return only the locations that have capacity for the mveImageId. If the mveImageId is not passed in, the `mveMaxCpuCoreCount` value will always be null.
* Added the MCR speed field (`mcrSpeedMbps`).

## Notification Preferences and CXC Endpoint Removal

**New /v3/notificationPreferences Endpoint** – The `/v3/notificationPreferences` endpoint has been added to allow users to subscribe to individual notifications or notification groups in the Megaport Portal. This endpoint replaces the previous `/v2/notificationPreferences` endpoint. For more information, see [Email Notifications](/api-reference).

**Removed the PUT /v2/product/cxc/\{productUid} Endpoint** – The `PUT /v2/product/cxc` endpoint has been deprecated as all active CXC services have been migrated to VXCs. Users should access the `PUT /v2/product/vxc/{productUid}` endpoint instead.

## Oracle Virtual Circuit ID Now Returned

**Oracle Virtual Circuit ID Now Returned** – Improvements have been made to the public APIs relating to Oracle VXCs. The `virtualCircuitId` field (the VLAN ID on the Oracle side of the VXC) is now returned in the response for these APIs:

* `GET /v2/product/{uid}`
* `GET /v2/products`
* `POST /v3/networkdesign/validate`
* `POST /v3/networkdesign/buy`

## Activity Logging

**Activity Logging** – Improvements have been made to the account activity information that is logged and displayed in the Megaport Portal. A new API `v3/activity` has also been created that can be used to retrieve activity logs for the logged-in user.

## API v2 Deprecation and Invoice Updates

**Deprecate v2 APIs Replaced by v3 APIs** – As previously communicated, some of our v2 APIs have been superseded by v3 versions and were scheduled for deprecation. These v2 APIs have now been officially deprecated and no longer supported by Megaport:

* Get MVE Price: `GET /v2/pricebook/mve`
* Get VXC Price: `GET /v2/pricebook/vxc`
* Validate Orders: `POST /v2/networkdesign/validate`
* Buy Services: `POST /v2/networkdesign/buy`
* Update VXC Details: `PUT /v2/product/vxc/{productUid}`
* Delete Services: `POST /v2/product/{productUid}/action/{action}`

For more information, see [API v2 Shutdown FAQs](/api-reference).

**Updated Invoice APIs from v2 to v3** – The invoice APIs have been updated from v2 to v3, and to support companyUid.

* `GET /v3/company/${companyUid}/invoice/supplierId/{supplierId}?fromDate=${fromDate}&toDate=${toDate}`
* `GET /v3/company/${companyUid}/invoice/${invoiceId}`
* `GET /v3/company/${companyUid}/invoice/${invoiceId}/pdf`
* `GET /v3/company/${companyUid}/invoice/${invoiceId}/csv`

**Resource Tags Added to Invoice Report** – Resource tags for services have been added to the Invoices report (CSV only). This allows you to export tagging information for external analysis.

**Added Diversity Zone in Response for CSPs** – Previously customers who wanted to connect to a CSP were not able to see the diversity zone they were connecting to when reviewing available ports. The diversity zone information has now been added to the response that is returned so customers can determine the diversity zone they are connecting to for a given service. For example, the response that is returned in this request will now include diversity zone: `/v2/secure/google/{pairing_key}`.

## MCR BFD Timer Settings Removed

**Removed MCR BFD Timer Settings** – Support for maintaining MCR BFD timer settings has been removed from the API. The BFD settings are not editable, the default values configured when BFD is enabled are Transmit Interval: 300 milliseconds, Receive Interval: 300 milliseconds, Multiplier: 3.

## Resource Tagging and New MVE Endpoints

**Resource Tagging** – Customers now have the ability to create, modify, and delete resource tags to manage their active services via the Megaport API. Resource tags are key and value pairs that act as metadata for organizing Megaport resources. These tags will appear in the Service Inventory report by default for the company who has implemented the tags providing they own the service the tag is put against.

**New Endpoints for MVE** – The new endpoints `GET v3/locations` and `GET v4/product/mve/images` have been added. v3/locations and v4/product/mve/images are intended to replace v2/locations and v3/product/mve/images. The MVE details have moved to v4/product/mve/images. If the v3/locations diversityZones has a value in the mveMaxCpuCoreCount then you can order any MVE from the v4/product/mve/images endpoint as long as the size is less than the maxMaxCpuCoreCount.

**Add Max Length Validation to Service Level Reference Field** – Validations have been changed for the Service Level Reference field (`costCentre`) so that this field now has a maximum value of 255 characters.

**Fixed** – API was responding with a 400 error instead of a 404 when querying a product that doesn't exist.

## Telemetry CSV Download and Performance Improvements

**Telemetry CSV Download** – The service telemetry APIs can now download utilization data in CSV format as well as text format. For more information, see [Metric Types](/api-reference).

**GET /v2/product/\{productUid} Speed Improvements** – The performance of this API has been optimised. In some cases, the load time for this API for larger companies has halved.

## Maintenance and Outage Event Monitoring

**Support for Monitoring Maintenance and Outage Events** – The `/ens/v1/status/outage` and `/ens/v1/status/maintenance` public APIs have been created which allow you to monitor maintenance activities and service outages. For more information, see [Maintenance and Outage Events](/api-reference).

**Fixed** – NPE errors were occurring in the `/v2/employment` endpoint because the user did not have an email address defined.

## Megaport Internet Available in More Countries

**Megaport Internet Available in More Countries** – Megaport Internet connections can now also be ordered from Ports and MCRs in New Zealand, Canada, and Singapore, in addition to Australia, UK and the US where it was already available.

## New /v3/login API and GSA/GRA Update

**New /v3/login API** – A new `/v3/login` API has been created to replace the soon to be deprecated `/v2/login` API. The v2 API will no longer be supported; please migrate any API integrations you have from the v2 version to the new v3 API version.

**GSA/GRA Updated** – Megaport has updated the standard Global Services Agreement (GSA) and Global Reseller Agreement (GRA) terms (in accordance with Clauses 15(a) and 20(a) respectively). As part of this update, the early termination fee (ETF) applied to a service on a contract that is canceled before the term is complete has changed from 50% to 100%. This change took effect in the Megaport Portal on April 15, 2024.

## Service Inventory API and MVE API Updates

**New Service Inventory API** – A new public API `/v2/secure/inventory/companies/{companyUid}/services/csv` has been created which allows you to download your service inventory, including historical services, in comma-separated values (CSV) file format. You can also return the service inventory in JSON format using the `/v2/secure/inventory/companies/{companyUid}/services` API. For more information, see [Service Inventory Report](/api-reference).

**Updated GET Available MVE Sizes API** – The GET Available MVE Sizes `/v2/product/mve/variants` API has been updated to remove the `bandwidthMbps` parameter from the response.

**MVE validate/buy API Changes to Remove Vendor** – Changes have been made to the following MVE APIs to remove `vendor` as a required parameter. This parameter is no longer required, and if passed it will just be ignored.

* `/v2/networkdesign/validate`
* `/v3/networkdesign/validate`
* `/v2/networkdesign/buy`
* `/v3/networkdesign/buy`

## New Invoice APIs, Diversity Zones, and VXC Shutdown

**New Invoice APIs** – To ensure you keep receiving the most accurate, up-to-date and complete invoice data, including credit notes and tax information, you are required to migrate to the new invoice API endpoints. For more information, see [New Invoice APIs FAQs](/api-reference) and [Invoices](/api-reference).

**MCR and MVE Diversity** – You can now choose a diversity zone when creating MCRs and MVEs. You can pass the `diversityZone` parameter when validating and ordering an MCR and MVE via API. For more information, see [Buy MCR (v3)](/api-reference) and the Buy MVE (v3) endpoint for the relevant vendor.

**VXC Shutdown added to the Create Screen** – The VXC and IX shutdown feature has been expanded so that you can now shut down a VXC and IX service when creating the service. Previously it could be done only when editing the service. You can now pass the `shutdown` parameter in the v2/v3 validate and buy API endpoints. If not passed, it defaults to FALSE (Enabled).

## VXC Terms and Improved Telemetry API

**Terms on VXC** – VXCs can now be put on a 12, 24, or 36 month term. The following APIs have been updated to accept the new optional field `term` to put a VXC on term:

* `POST /v3/networkdesign/validate`
* `POST /v3/networkdesign/buy`
* `PUT /v3/product/vxc/{productUid}`

Acceptable values for `term` are: 1, 12, 24, 36. If `term` is not provided when validating and ordering a VXC, it defaults to 1 (No Minimum Term). If `term` is not provided when updating a VXC, the existing value is not updated.

**Improved Telemetry API** – The following enhancements have been made to the Telemetry APIs:

* You can now specify a time span in 'days in the past' instead of needing exact dates.
* You can ask for multiple metrics in a single request (for example, bit rate + packet rate) to reduce the number of requests needed.

For more information, see [Metric Types](/api-reference).

**AWS HC Fetch Supported Bandwidths** – A new public API `/v2/secure/awshc` has been created to look up AWS HC ports with supported bandwidth options.

_Showing the 20 most recent of 25 entries. Append `/llms.txt` to the changelog URL for the complete index._