Log Explorer API

Last updated Oct 15, 2026 Configuration and Log searches are also available via a public API.

Authentication

Authentication with the API can be done via an API token or API key with an email. Refer to Create API token for further instructions.

For detailed information on permissions required for each feature, refer to the Permissions section.

Query data

Log Explorer includes a SQL API for submitting queries.

For example, to find an HTTP request with a specific Ray ID, use the following SQL query:

curl https://api.cloudflare.com/client/v4/zones/{zone_id}/logs/explorer/query/sql \
--header "Authorization: Bearer <API_TOKEN>" \
--url-query query="SELECT clientRequestScheme, clientRequestHost, clientRequestMethod, edgeResponseStatus, clientRequestUserAgent FROM http_requests WHERE RayID = '806c30a3cec56817' LIMIT 1"

This command returns the following HTTP request details:

{
    "result": [
        {
            "clientrequestscheme": "https",
            "clientrequesthost": "example.com",
            "clientrequestmethod": "GET",
            "clientrequestuseragent": "curl/7.88.1",
            "edgeresponsestatus": 200
        }
    ],
    "success": true,
    "errors": [],
    "messages": []
}

As another example, you could find Cloudflare Access requests with selected columns from a specific timeframe by performing the following SQL query:

curl https://api.cloudflare.com/client/v4/accounts/{account_id}/logs/explorer/query/sql \
--header "Authorization: Bearer <API_TOKEN>" \
--url-query query="SELECT CreatedAt, AppDomain, AppUUID, Action, Allowed, Country, RayID, Email, IPAddress, UserUID FROM access_requests WHERE Date >= '2025-02-06' AND Date <= '2025-02-06' AND CreatedAt >= '2025-02-06T12:28:39Z' AND CreatedAt <= '2025-02-06T12:58:39Z'"

This command returns the following request details:

{
    "result": [
        {
            "createdat": "2025-01-14T18:17:55Z",
            "appdomain": "example.com",
            "appuuid": "a66b4ab0-ccdf-4d60-a6d0-54a59a827d92",
            "action": "login",
            "allowed": true,
            "country": "us",
            "rayid": "90fbb07c0b316957",
            "email": "user@example.com",
            "ipaddress": "1.2.3.4",
            "useruid": "52859e81-711e-4de0-8b31-283336060e79"
        }
    ],
    "success": true,
    "errors": [],
    "messages": []
}

Was this helpful?

YesNo

On this page

Log Explorer API - 图1Docs

{"@context":"https://schema.org","@type":"TechArticle","@id":"https://developers.cloudflare.com/observability/logs/log-explorer/api/#page","headline":"Log Explorer API","description":"Query and configure Log Explorer via the API.","url":"https://developers.cloudflare.com/observability/logs/log-explorer/api/","inLanguage":"en","image":"https://developers.cloudflare.com/observability/logs/log-explorer/api/og.png?v=8c4c19f1b2404d62","dateModified":"2026-10-15","publisher":{"@type":"Organization","name":"Cloudflare","description":"One platform for your apps, agents, and workforce. Build, secure, and scale without managing infrastructure","url":"https://www.cloudflare.com/","sameAs":["https://github.com/cloudflare","https://www.linkedin.com/company/cloudflare","https://x.com/cloudflare"],"logo":{"@type":"ImageObject","url":"https://developers.cloudflare.com/logo.svg"},"address":{"@type":"PostalAddress","streetAddress":"101 Townsend St","addressLocality":"San Francisco","addressRegion":"CA","postalCode":"94107","addressCountry":"US"},"contactPoint":[{"@type":"ContactPoint","contactType":"Customer Support","url":"https://support.cloudflare.com/","availableLanguage":["English"]},{"@type":"ContactPoint","contactType":"Sales","url":"https://www.cloudflare.com/contact/","availableLanguage":["English"]}]},"isPartOf":{"@type":"WebSite","@id":"https://developers.cloudflare.com/#website","name":"Cloudflare Docs","url":"https://developers.cloudflare.com/"}}

description: View recent changes to Cloudflare Logs. title: Changelog image: https://developers.cloudflare.com/observability/logs/log-explorer/changelog/og.png?v=8bc4946606370755

Skip to content

Documentation Index
Fetch the complete documentation index at: https://developers.cloudflare.com/observability/llms.txt
Use this file to discover all available pages before exploring further.