Return All Control Plane IP Addresses

GET /api/atlas/v2/unauth/controlPlaneIPAddresses

Returns all control plane IP addresses.

Query parameters

  • envelope boolean

    Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.

    Default value is false.

Responses

  • 200 application/vnd.atlas.2023-11-15+json

    OK

    Hide response attributes Show response attributes object
    • inbound object

      List of inbound IP addresses to the Atlas control plane, categorized by cloud provider. If your application allows outbound HTTP requests only to specific IP addresses, you must allow access to the following IP addresses so that your API requests can reach the Atlas control plane.

      Hide inbound attributes Show inbound attributes object
      • aws object

        Control plane IP addresses in AWS. Each key identifies an Amazon Web Services (AWS) region. Each value identifies control plane IP addresses in the AWS region.

        Hide aws attribute Show aws attribute object
        • * array[string] Additional properties

          Control plane IP addresses in AWS. Each key identifies an Amazon Web Services (AWS) region. Each value identifies control plane IP addresses in the AWS region.

      • azure object

        Control plane IP addresses in Azure. Each key identifies an Azure region. Each value identifies control plane IP addresses in the Azure region.

        Hide azure attribute Show azure attribute object
        • * array[string] Additional properties

          Control plane IP addresses in Azure. Each key identifies an Azure region. Each value identifies control plane IP addresses in the Azure region.

      • gcp object

        Control plane IP addresses in GCP. Each key identifies a Google Cloud (GCP) region. Each value identifies control plane IP addresses in the GCP region.

        Hide gcp attribute Show gcp attribute object
        • * array[string] Additional properties

          Control plane IP addresses in GCP. Each key identifies a Google Cloud (GCP) region. Each value identifies control plane IP addresses in the GCP region.

    • outbound object

      List of outbound IP addresses from the Atlas control plane, categorized by cloud provider. If your network allows inbound HTTP requests only from specific IP addresses, you must allow access from the following IP addresses so that Atlas can communicate with your webhooks and KMS.

      Hide outbound attributes Show outbound attributes object
      • aws object

        Control plane IP addresses in AWS. Each key identifies an Amazon Web Services (AWS) region. Each value identifies control plane IP addresses in the AWS region.

        Hide aws attribute Show aws attribute object
        • * array[string] Additional properties

          Control plane IP addresses in AWS. Each key identifies an Amazon Web Services (AWS) region. Each value identifies control plane IP addresses in the AWS region.

      • azure object

        Control plane IP addresses in Azure. Each key identifies an Azure region. Each value identifies control plane IP addresses in the Azure region.

        Hide azure attribute Show azure attribute object
        • * array[string] Additional properties

          Control plane IP addresses in Azure. Each key identifies an Azure region. Each value identifies control plane IP addresses in the Azure region.

      • gcp object

        Control plane IP addresses in GCP. Each key identifies a Google Cloud (GCP) region. Each value identifies control plane IP addresses in the GCP region.

        Hide gcp attribute Show gcp attribute object
        • * array[string] Additional properties

          Control plane IP addresses in GCP. Each key identifies a Google Cloud (GCP) region. Each value identifies control plane IP addresses in the GCP region.
  • 500 application/json

    Internal Server Error.

    Hide response attributes Show response attributes object
    • badRequestDetail object

      Bad request detail.

      Hide badRequestDetail attribute Show badRequestDetail attribute object
      • fields array[object]

        Describes all violations in a client request.

        Hide fields attributes Show fields attributes object
        • description string Required

          A description of why the request element is bad.

        • field string Required

          A path that leads to a field in the request body.

    • detail string

      Describes the specific conditions or reasons that cause each type of error.

    • error integer(int32) Required

      HTTP status code returned with this error.

      External documentation
    • errorCode string Required

      Application error code returned with this error.

    • parameters array[object]

      Parameters used to give more information about the error.

    • reason string

      Application error message returned with this error.
GET /api/atlas/v2/unauth/controlPlaneIPAddresses 
atlas api root listControlPlaneIpAddresses --help
import (	"os"	"context"	"log"	sdk "go.mongodb.org/atlas-sdk/v20250312001/admin" ) func main() {	ctx := context.Background()	clientID := os.Getenv("MONGODB_ATLAS_CLIENT_ID")	clientSecret := os.Getenv("MONGODB_ATLAS_CLIENT_SECRET")	// See https://dochub.mongodb.org/core/atlas-go-sdk-oauth	client, err := sdk.NewClient(sdk.UseOAuthAuth(clientID, clientSecret))	if err != nil {	log.Fatalf("Error: %v", err)	}	params = &sdk.ListControlPlaneIpAddressesApiParams{}	sdkResp, httpResp, err := client.RootApi.	ListControlPlaneIpAddressesWithParams(ctx, params).	Execute() } 
curl --include --header "Authorization: Bearer ${ACCESS_TOKEN}" \ --header "Accept: application/vnd.atlas.2025-03-12+json" \ -X GET "https://cloud.mongodb.com/api/atlas/v2/unauth/controlPlaneIPAddresses?pretty=true"
curl --user "${PUBLIC_KEY}:${PRIVATE_KEY}" \ --digest --include \ --header "Accept: application/vnd.atlas.2025-03-12+json" \ -X GET "https://cloud.mongodb.com/api/atlas/v2/unauth/controlPlaneIPAddresses?pretty=true"
Response examples (200) 
{ "inbound": { "aws": { "additionalProperty1": [ "string" ], "additionalProperty2": [ "string" ] }, "azure": { "additionalProperty1": [ "string" ], "additionalProperty2": [ "string" ] }, "gcp": { "additionalProperty1": [ "string" ], "additionalProperty2": [ "string" ] } }, "outbound": { "aws": { "additionalProperty1": [ "string" ], "additionalProperty2": [ "string" ] }, "azure": { "additionalProperty1": [ "string" ], "additionalProperty2": [ "string" ] }, "gcp": { "additionalProperty1": [ "string" ], "additionalProperty2": [ "string" ] } } }
Response examples (500) 
{ "error": 500, "detail": "(This is just an example, the exception may not be related to this endpoint)", "reason": "Internal Server Error", "errorCode": "UNEXPECTED_ERROR" }