Skip to navigation
API ReferenceLocationsVersion 2 (v2) endpoints - to be deprecated July 2025

Locations (v2)

Deprecated
View as Markdown

Returns a list of data centers where you can order a Megaport, MCR, or MVE. You use the id field to identify a data center in API calls for orders.

You can search the response for attributes such as country, metro, and city, and each location also includes latitude and longitude details.

If a location supports diversity zones, the response contains a diversityZones object that identifies which diversity zone has availability for a new Port, MCR, or MVE. For ports it will also show the supported Port speeds for each zone.

The MVE sizes object checks for resource availability and returns the available MVE sizes for that vendor and location. An empty sizes array indicates there are no instance sizes available for that vendor and location.

The MVE details object returns all available sizes with their details, including label, cpuCoreCount, bandwidthMbps and ramGb.

You can filter the location results to focus the response. You can filter for locationStatuses (to display only Active, Configured, Expired, and so on), and you can also filter based on MVE SD-WAN vendors and for metros.

Query parameters

locationStatusesstringOptional

Filter results based on specified status. This parameter can be added multiple times to capture multiple status values. Status values include: “Extended” “Deployment” “Active” “New” “Restricted” “Expired”. (Optional)

metrostringOptional

Filter results to only include locations in the named metro. (Optional)

mveVendorstringOptional
The name of the vendor of the product used to create the MVE. The current vendors are Aruba, Cisco, Fortinet, Versa, VMWare, and Palo Alto.
marketEnabledstringOptional
If true, return only the locations in the enabled markets. Default value is false.

Response

Locations - Active DCs in Singapore / Locations - Active Cisco in LA / Locations - Active Versa in LA / Locations - Active Cisco in LA / Locations - Active Versa in LA / Locations - Active DCs in Singapore

datalist of objectsOptional
messagestringOptional
termsstringOptional