--- title: List Monitors --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api) [Load Balancers](https://developers.cloudflare.com/api/resources/load_balancers) [Monitors](https://developers.cloudflare.com/api/resources/load_balancers/subresources/monitors) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # List Monitors GET/accounts/{account\_id}/load\_balancers/monitors List configured monitors for an account. ##### 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) `Load Balancing: Monitors and Pools Write``Load Balancing: Monitors and Pools Read` ##### P ath ParametersExpand Collapse account\_id: string Identifier. maxLength32 [Link to this property](<#(resource)%20load_balancers.monitors%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20account_id%20%3E%20(schema)>) ##### ReturnsExpand Collapse

errors: 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)%20load_balancers.monitors%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)%20load_balancers.monitors%20%3E%20(method)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20messages>)

result: array of Monitor { id, allow\_insecure, consecutive\_down, 16 more }

id: optional string Link to this property allow\_insecure: optional boolean Do not validate the certificate when monitor use HTTPS. This parameter is currently only valid for HTTP and HTTPS monitors. Link to this property consecutive\_down: optional number To be marked unhealthy the monitored origin must fail this healthcheck N consecutive times. Link to this property consecutive\_up: optional number To be marked healthy the monitored origin must pass this healthcheck N consecutive times. Link to this property created\_on: optional string Link to this property description: optional string Object description. Link to this property expected\_body: optional string A case-insensitive sub-string to look for in the response body. If this string is not found, the origin will be marked as unhealthy. This parameter is only valid for HTTP and HTTPS monitors. Link to this property expected\_codes: optional string The expected HTTP response code or code range of the health check. This parameter is only valid for HTTP and HTTPS monitors. Link to this property follow\_redirects: optional boolean Follow redirects if returned by the origin. This parameter is only valid for HTTP and HTTPS monitors. Link to this property header: optional map\[array of string] The HTTP request headers to send in the health check. It is recommended you set a Host header by default. The User-Agent header cannot be overridden. This parameter is only valid for HTTP and HTTPS monitors. Link to this property interval: optional number The interval between each health check. Shorter intervals may improve failover time, but will increase load on the origins as we check from multiple locations. Link to this property method: optional string The method to use for the health check. This defaults to ‘GET’ for HTTP/HTTPS based checks and ‘connection\_established’ for TCP based health checks. Link to this property modified\_on: optional string Link to this property path: optional string The endpoint path you want to conduct a health check against. This parameter is only valid for HTTP and HTTPS monitors. Link to this property port: optional number The port number to connect to for the health check. Required for TCP, UDP, and SMTP checks. HTTP and HTTPS checks should only define the port when using a non-standard port (HTTP: default 80, HTTPS: default 443). Link to this property probe\_zone: optional string Assign this monitor to emulate the specified zone while probing. This parameter is only valid for HTTP and HTTPS monitors. Link to this property retries: optional number The number of retries to attempt in case of a timeout before marking the origin as unhealthy. Retries are attempted immediately. Link to this property timeout: optional number The timeout (in seconds) before marking the health check as failed. Link to this property

type: optional "http"or "https"or "tcp"or 3 more The protocol to use for the health check. Currently supported protocols are ‘HTTP’,‘HTTPS’, ‘TCP’, ‘ICMP-PING’, ‘UDP-ICMP’, and ‘SMTP’.

One of the following: "http" Link to this property "https" Link to this property "tcp" Link to this property "udp\_icmp" Link to this property "icmp\_ping" Link to this property "smtp" Link to this property

Link to this property

[Link to this property](<#(resource)%20load_balancers.monitors%20%3E%20(method)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20result>) success: true Whether the API call was successful. [Link to this property](<#(resource)%20load_balancers.monitors%20%3E%20(method)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20success>)

result\_info: optional object {count, page, per\_page, 2 more }

count: optional number Total number of results on the current page. Link to this property page: optional number Current page within paginated list of results. Link to this property per\_page: optional number Number of results per page. Link to this property total\_count: optional number Total results available without any search parameters. Link to this property total\_pages: optional number Total number of pages available. Link to this property

[Link to this property](<#(resource)%20load_balancers.monitors%20%3E%20(method)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20result_info>) ### List Monitors HTTP HTTPTypeScriptPythonGoTerraform ``` curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/load_balancers/monitors \ -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": "f1aba936b94213e5b8dca0c0dbf1f9cc", "allow_insecure": true, "consecutive_down": 0, "consecutive_up": 0, "created_on": "2014-01-01T05:20:00.12345Z", "description": "Login page monitor", "expected_body": "alive", "expected_codes": "2xx", "follow_redirects": true, "header": { "Host": [ "example.com" ], "X-App-ID": [ "abc123" ] }, "interval": 0, "method": "GET", "modified_on": "2014-01-01T05:20:00.12345Z", "path": "/health", "port": 0, "probe_zone": "example.com", "retries": 0, "timeout": 0, "type": "https" } ], "success": true, "result_info": { "count": 20, "page": 1, "per_page": 20, "total_count": 2000, "total_pages": 100 } } ``` ##### 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": "f1aba936b94213e5b8dca0c0dbf1f9cc", "allow_insecure": true, "consecutive_down": 0, "consecutive_up": 0, "created_on": "2014-01-01T05:20:00.12345Z", "description": "Login page monitor", "expected_body": "alive", "expected_codes": "2xx", "follow_redirects": true, "header": { "Host": [ "example.com" ], "X-App-ID": [ "abc123" ] }, "interval": 0, "method": "GET", "modified_on": "2014-01-01T05:20:00.12345Z", "path": "/health", "port": 0, "probe_zone": "example.com", "retries": 0, "timeout": 0, "type": "https" } ], "success": true, "result_info": { "count": 20, "page": 1, "per_page": 20, "total_count": 2000, "total_pages": 100 } } ```