--- title: List Cloud Integrations --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api) [Magic Cloud Networking](https://developers.cloudflare.com/api/resources/magic_cloud_networking) [Cloud Integrations](https://developers.cloudflare.com/api/resources/magic_cloud_networking/subresources/cloud_integrations) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # List Cloud Integrations GET/accounts/{account\_id}/magic/cloud/providers List Cloud Integrations (Closed Beta). ##### Security

API Token

The preferred authorization scheme for interacting with the Cloudflare API. Create a token. **Example:**Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY

API Email + API Key

The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key. **Example:**X-Auth-Email: user@example.com The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys. **Example:**X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194

##### Accepted Permissions (at least one required) `Magic WAN Write``Magic WAN Read` ##### P ath ParametersExpand Collapse account\_id: string [Link to this property](<#(resource)%20magic_cloud_networking.cloud_integrations%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20account_id%20%3E%20(schema)>) ##### Q uery ParametersExpand Collapse cloudflare: optional boolean [Link to this property](<#(resource)%20magic_cloud_networking.cloud_integrations%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20cloudflare%20%3E%20(schema)>) desc: optional boolean [Link to this property](<#(resource)%20magic_cloud_networking.cloud_integrations%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20desc%20%3E%20(schema)>) order\_by: optional string One of \[“updated\_at”, “id”, “cloud\_type”, “name”]. [Link to this property](<#(resource)%20magic_cloud_networking.cloud_integrations%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20order_by%20%3E%20(schema)>) status: optional boolean [Link to this property](<#(resource)%20magic_cloud_networking.cloud_integrations%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20status%20%3E%20(schema)>) ##### ReturnsExpand Collapse

errors: array of object {code, message, documentation\_url, 2 more } maxLength0

code: 1001or 1002or 1003or 152 more

Link to this property message: string Link to this property documentation\_url: optional string Link to this property

meta: optional object {l10n\_key, loggable\_error, template\_data, trace\_id }

l10n\_key: optional string Link to this property loggable\_error: optional string Link to this property template\_data: optional unknown Link to this property trace\_id: optional string Link to this property

Link to this property

source: optional object {parameter, parameter\_value\_index, pointer }

parameter: optional string Link to this property parameter\_value\_index: optional number Link to this property pointer: optional string Link to this property

Link to this property

[Link to this property](<#(resource)%20magic_cloud_networking.cloud_integrations%20%3E%20(method)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20errors>)

messages: array of object {code, message, documentation\_url, 2 more }

code: 1001or 1002or 1003or 152 more

Link to this property message: string Link to this property documentation\_url: optional string Link to this property

meta: optional object {l10n\_key, loggable\_error, template\_data, trace\_id }

Link to this property

source: optional object {parameter, parameter\_value\_index, pointer }

parameter: optional string Link to this property parameter\_value\_index: optional number Link to this property pointer: optional string Link to this property

Link to this property

[Link to this property](<#(resource)%20magic_cloud_networking.cloud_integrations%20%3E%20(method)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20messages>)

result: array of object {id, cloud\_type, friendly\_name, 11 more }

id: string formatuuid Link to this property

cloud\_type: "AWS"or "AZURE"or "GOOGLE"or "CLOUDFLARE"

One of the following: "AWS" Link to this property "AZURE" Link to this property "GOOGLE" Link to this property "CLOUDFLARE" Link to this property

Link to this property friendly\_name: string Link to this property last\_updated: string Link to this property

lifecycle\_state: "ACTIVE"or "PENDING\_SETUP"or "RETIRED"

One of the following: "ACTIVE" Link to this property "PENDING\_SETUP" Link to this property "RETIRED" Link to this property

Link to this property

state: "UNSPECIFIED"or "PENDING"or "DISCOVERING"or 2 more

One of the following: "UNSPECIFIED" Link to this property "PENDING" Link to this property "DISCOVERING" Link to this property "FAILED" Link to this property "SUCCEEDED" Link to this property

Link to this property

state\_v2: "UNSPECIFIED"or "PENDING"or "DISCOVERING"or 2 more

One of the following: "UNSPECIFIED" Link to this property "PENDING" Link to this property "DISCOVERING" Link to this property "FAILED" Link to this property "SUCCEEDED" Link to this property

Link to this property aws\_arn: optional string Link to this property azure\_subscription\_id: optional string Link to this property azure\_tenant\_id: optional string Link to this property description: optional string Link to this property gcp\_project\_id: optional string Link to this property gcp\_service\_account\_email: optional string Link to this property

status: optional object {discovery\_progress, discovery\_progress\_v2, last\_discovery\_status, 13 more }

discovery\_progress: object {done, total, unit }

done: number Link to this property total: number Link to this property unit: string Link to this property

Link to this property

discovery\_progress\_v2: object {done, total, unit }

done: number Link to this property total: number Link to this property unit: string Link to this property

Link to this property

last\_discovery\_status: "UNSPECIFIED"or "PENDING"or "DISCOVERING"or 2 more

One of the following: "UNSPECIFIED" Link to this property "PENDING" Link to this property "DISCOVERING" Link to this property "FAILED" Link to this property "SUCCEEDED" Link to this property

Link to this property

last\_discovery\_status\_v2: "UNSPECIFIED"or "PENDING"or "DISCOVERING"or 2 more

One of the following: "UNSPECIFIED" Link to this property "PENDING" Link to this property "DISCOVERING" Link to this property "FAILED" Link to this property "SUCCEEDED" Link to this property

Link to this property regions: array of string Link to this property credentials\_good\_since: optional string Link to this property credentials\_missing\_since: optional string Link to this property credentials\_rejected\_since: optional string Link to this property discovery\_message: optional string Link to this property discovery\_message\_v2: optional string Link to this property

in\_use\_by: optional array of object {id, client\_type, name }

id: string formatuuid Link to this property client\_type: "MAGIC\_WAN\_CLOUD\_ONRAMP" Link to this property name: string Link to this property

Link to this property last\_discovery\_completed\_at: optional string Link to this property last\_discovery\_completed\_at\_v2: optional string Link to this property last\_discovery\_started\_at: optional string Link to this property last\_discovery\_started\_at\_v2: optional string Link to this property last\_updated: optional string Link to this property

Link to this property

[Link to this property](<#(resource)%20magic_cloud_networking.cloud_integrations%20%3E%20(method)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20result>) success: boolean [Link to this property](<#(resource)%20magic_cloud_networking.cloud_integrations%20%3E%20(method)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20success>) ### List Cloud Integrations HTTP HTTPTypeScriptPythonGoTerraform ``` curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/magic/cloud/providers \ -H "Authorization: Bearer $CLOUDFLARE_API_TOKEN" ``` 200 example ``` { "errors": [ { "code": 1001, "message": "message", "documentation_url": "documentation_url", "meta": { "l10n_key": "l10n_key", "loggable_error": "loggable_error", "template_data": {}, "trace_id": "trace_id" }, "source": { "parameter": "parameter", "parameter_value_index": 0, "pointer": "pointer" } } ], "messages": [ { "code": 1001, "message": "message", "documentation_url": "documentation_url", "meta": { "l10n_key": "l10n_key", "loggable_error": "loggable_error", "template_data": {}, "trace_id": "trace_id" }, "source": { "parameter": "parameter", "parameter_value_index": 0, "pointer": "pointer" } } ], "result": [ { "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e", "cloud_type": "AWS", "friendly_name": "friendly_name", "last_updated": "last_updated", "lifecycle_state": "ACTIVE", "state": "UNSPECIFIED", "state_v2": "UNSPECIFIED", "aws_arn": "aws_arn", "azure_subscription_id": "azure_subscription_id", "azure_tenant_id": "azure_tenant_id", "description": "description", "gcp_project_id": "gcp_project_id", "gcp_service_account_email": "gcp_service_account_email", "status": { "discovery_progress": { "done": 0, "total": 0, "unit": "unit" }, "discovery_progress_v2": { "done": 0, "total": 0, "unit": "unit" }, "last_discovery_status": "UNSPECIFIED", "last_discovery_status_v2": "UNSPECIFIED", "regions": [ "string" ], "credentials_good_since": "credentials_good_since", "credentials_missing_since": "credentials_missing_since", "credentials_rejected_since": "credentials_rejected_since", "discovery_message": "discovery_message", "discovery_message_v2": "discovery_message_v2", "in_use_by": [ { "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e", "client_type": "MAGIC_WAN_CLOUD_ONRAMP", "name": "name" } ], "last_discovery_completed_at": "last_discovery_completed_at", "last_discovery_completed_at_v2": "last_discovery_completed_at_v2", "last_discovery_started_at": "last_discovery_started_at", "last_discovery_started_at_v2": "last_discovery_started_at_v2", "last_updated": "last_updated" } } ], "success": true } ``` ##### Returns Examples 200 example ``` { "errors": [ { "code": 1001, "message": "message", "documentation_url": "documentation_url", "meta": { "l10n_key": "l10n_key", "loggable_error": "loggable_error", "template_data": {}, "trace_id": "trace_id" }, "source": { "parameter": "parameter", "parameter_value_index": 0, "pointer": "pointer" } } ], "messages": [ { "code": 1001, "message": "message", "documentation_url": "documentation_url", "meta": { "l10n_key": "l10n_key", "loggable_error": "loggable_error", "template_data": {}, "trace_id": "trace_id" }, "source": { "parameter": "parameter", "parameter_value_index": 0, "pointer": "pointer" } } ], "result": [ { "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e", "cloud_type": "AWS", "friendly_name": "friendly_name", "last_updated": "last_updated", "lifecycle_state": "ACTIVE", "state": "UNSPECIFIED", "state_v2": "UNSPECIFIED", "aws_arn": "aws_arn", "azure_subscription_id": "azure_subscription_id", "azure_tenant_id": "azure_tenant_id", "description": "description", "gcp_project_id": "gcp_project_id", "gcp_service_account_email": "gcp_service_account_email", "status": { "discovery_progress": { "done": 0, "total": 0, "unit": "unit" }, "discovery_progress_v2": { "done": 0, "total": 0, "unit": "unit" }, "last_discovery_status": "UNSPECIFIED", "last_discovery_status_v2": "UNSPECIFIED", "regions": [ "string" ], "credentials_good_since": "credentials_good_since", "credentials_missing_since": "credentials_missing_since", "credentials_rejected_since": "credentials_rejected_since", "discovery_message": "discovery_message", "discovery_message_v2": "discovery_message_v2", "in_use_by": [ { "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e", "client_type": "MAGIC_WAN_CLOUD_ONRAMP", "name": "name" } ], "last_discovery_completed_at": "last_discovery_completed_at", "last_discovery_completed_at_v2": "last_discovery_completed_at_v2", "last_discovery_started_at": "last_discovery_started_at", "last_discovery_started_at_v2": "last_discovery_started_at_v2", "last_updated": "last_updated" } } ], "success": true } ```