--- title: List Connectors --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api) [Magic Transit](https://developers.cloudflare.com/api/resources/magic_transit) [Connectors](https://developers.cloudflare.com/api/resources/magic_transit/subresources/connectors) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # List Connectors GET/accounts/{account\_id}/magic/connectors Lists Magic WAN Connectors. ##### 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 maxLength32 [Link to this property](<#(resource)%20magic_transit.connectors%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20account_id%20%3E%20(schema)>) ##### Q uery ParametersExpand Collapse

device\_type: optional "MANAGED"or "LICENSED" Filter connectors by device type.

One of the following: "MANAGED" Link to this property "LICENSED" Link to this property

[Link to this property](<#(resource)%20magic_transit.connectors%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20device_type%20%3E%20(schema)>) ##### ReturnsExpand Collapse

errors: array of ResponseInfo { code, message, documentation\_url, source } maxLength0

code: number minimum1000 Link to this property message: string Link to this property documentation\_url: optional string Link to this property

source: optional object {pointer }

pointer: optional string Link to this property

Link to this property

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

messages: array of ResponseInfo { code, message, documentation\_url, source }

code: number minimum1000 Link to this property message: string Link to this property documentation\_url: optional string Link to this property

source: optional object {pointer }

pointer: optional string Link to this property

Link to this property

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

result: array of object {id, activated, interrupt\_window\_days\_of\_week, 10 more }

id: string Link to this property activated: boolean Link to this property

interrupt\_window\_days\_of\_week: array of "Sunday"or "Monday"or "Tuesday"or 4 more Allowed days of the week for upgrades. Default is all days.

One of the following: "Sunday" Link to this property "Monday" Link to this property "Tuesday" Link to this property "Wednesday" Link to this property "Thursday" Link to this property "Friday" Link to this property "Saturday" Link to this property

Link to this property interrupt\_window\_duration\_hours: number maximum24 minimum1 Link to this property interrupt\_window\_embargo\_dates: array of string List of dates (YYYY-MM-DD) when upgrades are blocked. Link to this property interrupt\_window\_hour\_of\_day: number Link to this property last\_updated: string Link to this property notes: string Link to this property timezone: string Link to this property

device: optional object {id, serial\_number, type }

id: string Link to this property serial\_number: optional string Link to this property

type: optional "MANAGED"or "LICENSED"

One of the following: "MANAGED" Link to this property "LICENSED" Link to this property

Link to this property

Link to this property last\_heartbeat: optional string Link to this property last\_seen\_version: optional string Link to this property license\_key: optional string Link to this property

[Link to this property](<#(resource)%20magic_transit.connectors%20%3E%20(method)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20result>) success: boolean [Link to this property](<#(resource)%20magic_transit.connectors%20%3E%20(method)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20success>) ### List Connectors HTTP HTTPTypeScriptPythonGoTerraform ``` curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/magic/connectors \ -H "Authorization: Bearer $CLOUDFLARE_API_TOKEN" ``` 200 example ``` { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "result": [ { "id": "id", "activated": true, "interrupt_window_days_of_week": [ "Sunday" ], "interrupt_window_duration_hours": 1, "interrupt_window_embargo_dates": [ "string" ], "interrupt_window_hour_of_day": 0, "last_updated": "last_updated", "notes": "notes", "timezone": "timezone", "device": { "id": "id", "serial_number": "serial_number", "type": "MANAGED" }, "last_heartbeat": "last_heartbeat", "last_seen_version": "last_seen_version", "license_key": "license_key" } ], "success": true } ``` ##### Returns Examples 200 example ``` { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "result": [ { "id": "id", "activated": true, "interrupt_window_days_of_week": [ "Sunday" ], "interrupt_window_duration_hours": 1, "interrupt_window_embargo_dates": [ "string" ], "interrupt_window_hour_of_day": 0, "last_updated": "last_updated", "notes": "notes", "timezone": "timezone", "device": { "id": "id", "serial_number": "serial_number", "type": "MANAGED" }, "last_heartbeat": "last_heartbeat", "last_seen_version": "last_seen_version", "license_key": "license_key" } ], "success": true } ```