--- title: List Connectors --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [Magic Transit](https://developers.cloudflare.com/api/python/resources/magic_transit) [Connectors](https://developers.cloudflare.com/api/python/resources/magic_transit/subresources/connectors) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # List Connectors magic\_transit.connectors.list(ConnectorListParams\*\*kwargs) -> SyncSinglePage\[[ConnectorListResponse]()] 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` ##### ParametersExpand Collapse account\_id: str 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)>)
device\_type: Optional\[Literal\["MANAGED", "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
class ConnectorListResponse: … id: str Link to this property activated: bool Link to this property
interrupt\_window\_days\_of\_week: List\[Literal\["Sunday", "Monday", "Tuesday", 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: float maximum24 minimum1 Link to this property interrupt\_window\_embargo\_dates: List\[str] List of dates (YYYY-MM-DD) when upgrades are blocked. Link to this property interrupt\_window\_hour\_of\_day: float Link to this property last\_updated: str Link to this property notes: str Link to this property timezone: str Link to this property
device: Optional\[Device] id: str Link to this property serial\_number: Optional\[str] Link to this property
type: Optional\[Literal\["MANAGED", "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\[str] Link to this property last\_seen\_version: Optional\[str] Link to this property license\_key: Optional\[str] Link to this property
[Link to this property](<#(resource)%20magic_transit.connectors%20%3E%20(model)%20connector_list_response%20%3E%20(schema)>) ### List Connectors Python HTTPTypeScriptPythonGoTerraform ``` import os from cloudflare import Cloudflare client = Cloudflare( api_token=os.environ.get("CLOUDFLARE_API_TOKEN"), # This is the default and can be omitted ) page = client.magic_transit.connectors.list( account_id="023e105f4ecef8ad9ca31a8372d0c353", ) page = page.result[0] print(page.id) ``` 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 } ```