[metadata]
algolia_content_type: Reference
algolia_product_filter: 1.1.1.1 (DNS Resolver)
description: Make programmatic DNS queries to 1.1.1.1 over HTTPS.
generator: Astro v7.2.0
generator: Nimbus v0.2.2
image: https://developers.cloudflare.com/og-docs.png
og:description: Make programmatic DNS queries to 1.1.1.1 over HTTPS.
og:image: https://developers.cloudflare.com/og-docs.png
og:locale: en
og:site_name: Cloudflare Docs
og:title: Make API requests to 1.1.1.1
og:title: Make API requests to 1.1.1.1 over DoH · Cloudflare 1.1.1.1 docs
og:type: article
og:url: https://developers.cloudflare.com/1.1.1.1/encryption/dns-over-https/make-api-requests/
pcx_additional_products: 1.1.1.1
pcx_content_group: Consumer services
pcx_content_type: Reference
pcx_last_modified: 107
pcx_product: 1.1.1.1 (DNS Resolver)
twitter:card: summary_large_image
twitter:image: https://developers.cloudflare.com/og-docs.png
twitter:site: @cloudflare
viewport: width=device-width, initial-scale=1

[canonical-links]
https://developers.cloudflare.com/1.1.1.1/encryption/dns-over-https/make-api-requests/

[document-links]
/
1.1.1.1 (DNS Resolver): /1.1.1.1/
1.1.1.1 Public DNS Resolver: /1.1.1.1/privacy/public-dns-resolver/
1.1.1.1 llms-full.txt ↗: /1.1.1.1/llms-full.txt
1.1.1.1 llms.txt ↗: /1.1.1.1/llms.txt
AI Security: https://www.cloudflare.com/solutions/ai-security/
API: /api/
About DoH: /1.1.1.1/encryption/dns-over-https/
About: https://www.cloudflare.com/about/
Agent setup ↗: /agent-setup/
Agent setup: /agent-setup/
Android: /1.1.1.1/setup/android/
App innovation report: https://www.cloudflare.com/resource/app-innovation-report/
Athenian Project: https://www.cloudflare.com/athenian/
Azure: /1.1.1.1/setup/azure/
Blog: https://blog.cloudflare.com/
Careers: https://www.cloudflare.com/careers/
Case studies: https://www.cloudflare.com/case-studies/
Changelog: /1.1.1.1/changelog/
Changelog: /changelog/
Cloudflare AI Cloud: https://www.cloudflare.com/solutions/ai/
Cloudflare Docs llms-full.txt ↗: /llms-full.txt
Cloudflare Docs llms.txt ↗: /llms.txt
Cloudflare Radar: https://radar.cloudflare.com/
Cloudflare Resolver for Firefox: /1.1.1.1/privacy/cloudflare-resolver-firefox/
Cloudflare Skills ↗: https://github.com/cloudflare/skills
Cloudflare for Campaigns: https://www.cloudflare.com/campaigns/
Code Mode MCP Server ↗: https://github.com/cloudflare/mcp
Community: https://community.cloudflare.com/
Compliance resources: https://www.cloudflare.com/trust-hub/compliance-resources/
Configure DoH on your browser: /1.1.1.1/encryption/dns-over-https/encrypted-dns-browsers/
Connect to 1.1.1.1 using DoH clients: /1.1.1.1/encryption/dns-over-https/dns-over-https-client/
Contact sales: https://www.cloudflare.com/resource/contact-enterprise-sales/
DNS Wireformat: /1.1.1.1/encryption/dns-over-https/make-api-requests/dns-wireformat/
DNS in Google Sheets: /1.1.1.1/additional-options/dns-in-google-sheets/
DNS over Discord: /1.1.1.1/additional-options/dns-over-discord/
DNS over HTTPS: /1.1.1.1/encryption/dns-over-https/
DNS over TLS: /1.1.1.1/encryption/dns-over-tls/
DNS over Tor: /1.1.1.1/additional-options/dns-over-tor/
DNS wireformat: /1.1.1.1/encryption/dns-over-https/make-api-requests/dns-wireformat/
DNSKEY: /1.1.1.1/encryption/dnskey/
Data Protection: https://www.cloudflare.com/trust-hub/gdpr/
Directory: /directory/
Docs: /
Documentation: https://developers.cloudflare.com/
Domain name search: https://domains.cloudflare.com/
Domain-specific MCP Servers ↗ MCP: https://github.com/cloudflare/mcp-server-cloudflare
Edit page: https://github.com/cloudflare/cloudflare-docs/edit/production/src/content/docs/1.1.1.1/encryption/dns-over-https/make-api-requests/index.mdx
Encryption: /1.1.1.1/encryption/
Events: https://www.cloudflare.com/events/
Extended DNS error codes: /1.1.1.1/infrastructure/extended-dns-error-codes/
FAQ: /1.1.1.1/faq/
Find a partner: https://partnerlocator.cloudflare.com/dashboard
Frontend Development Platform: https://www.cloudflare.com/solutions/frontends/
Gaming consoles: /1.1.1.1/setup/gaming-consoles/
General: /1.1.1.1/setup/
Global network: https://www.cloudflare.com/network/
Google Cloud: /1.1.1.1/setup/google-cloud/
Home: /
IP addresses: /1.1.1.1/ip-addresses/
Impact/ESG: https://www.cloudflare.com/impact/
Investors: https://cloudflare.net/
JSON: /1.1.1.1/encryption/dns-over-https/make-api-requests/dns-json/
Learning center: https://www.cloudflare.com/learning/
Linux: /1.1.1.1/setup/linux/
Log In: https://dash.cloudflare.com/login
Log in Dashboard: https://dash.cloudflare.com/
Multi-Tenant Platform Development: https://www.cloudflare.com/solutions/platforms/
Network operators: /1.1.1.1/infrastructure/network-operators/
Next DNS Wireformat: /1.1.1.1/encryption/dns-over-https/make-api-requests/dns-wireformat/
Oblivious DoH: /1.1.1.1/encryption/oblivious-dns-over-https/
Overview: /1.1.1.1
Overview: /1.1.1.1/encryption/
Overview: /1.1.1.1/encryption/dns-over-https/make-api-requests/
Overview: /1.1.1.1/privacy/
Partners: https://www.cloudflare.com/partners/
Plans: https://www.cloudflare.com/plans/
Press kit: https://www.cloudflare.com/press/press-kit/
Press: https://www.cloudflare.com/press/
Previous About DoH: /1.1.1.1/encryption/dns-over-https/
Privacy policy: https://www.cloudflare.com/policies/privacy/
Project Fairshot: https://www.cloudflare.com/fair-shot/
Project Galileo: https://www.cloudflare.com/galileo/
RFC 8484 ↗: https://datatracker.ietf.org/doc/html/rfc8484#section-5.2
Report abuse: https://www.cloudflare.com/trust-hub/abuse-approach/
Report issue: https://github.com/cloudflare/cloudflare-docs/issues/new/choose
Report security issues: https://www.cloudflare.com/disclosure/
Responsible AI: https://www.cloudflare.com/trust-hub/responsible-ai/
Router: /1.1.1.1/setup/router/
SDKs: /fundamentals/api/reference/sdks/
SLA and support: /1.1.1.1/infrastructure/sla-and-support/
SSE and SASE platform: https://www.cloudflare.com/sase/
Start Building: https://dash.cloudflare.com/sign-up
Startups: https://www.cloudflare.com/startups/
Status: https://www.cloudflarestatus.com/
Support for IPv6-only networks: /1.1.1.1/infrastructure/ipv6-networks/
Support: https://support.cloudflare.com/
Terms of use: /1.1.1.1/terms-of-use/
Terms of use: https://www.cloudflare.com/policies/terms/
Trademark: https://www.cloudflare.com/trademark/
Transparency report: https://www.cloudflare.com/transparency/
Troubleshooting: /1.1.1.1/troubleshooting/
Trust Hub: https://www.cloudflare.com/trust-hub/
Under attack?: https://www.cloudflare.com/under-attack-hotline/
Upstream resolution: /1.1.1.1/upstream-resolution/
Using JSON: /1.1.1.1/encryption/dns-over-https/make-api-requests/dns-json/
Verify connection: /1.1.1.1/check/
View as Markdown: index.md
Web Security Platform: https://www.cloudflare.com/solutions/security/
Windows: /1.1.1.1/setup/windows/
https://github.com/cloudflare/cloudflare-docs
iOS: /1.1.1.1/setup/ios/
macOS: /1.1.1.1/setup/macos/

[structured-data]
{"@context":"https://schema.org","@id":"https://developers.cloudflare.com/1.1.1.1/encryption/dns-over-https/make-api-requests/#page","@type":"TechArticle","dateModified":"2026-05-05","description":"Make programmatic DNS queries to 1.1.1.1 over HTTPS.","headline":"Make API requests to 1.1.1.1 over DoH · Cloudflare 1.1.1.1 docs","image":"https://developers.cloudflare.com/og-docs.png","inLanguage":"en","isPartOf":{"@id":"https://developers.cloudflare.com/#website","@type":"WebSite","name":"Cloudflare Docs","url":"https://developers.cloudflare.com/"},"publisher":{"@type":"Organization","name":"Cloudflare","url":"https://www.cloudflare.com/"},"url":"https://developers.cloudflare.com/1.1.1.1/encryption/dns-over-https/make-api-requests/"}

[content]
Make API requests to 1.1.1.1 over DoH · Cloudflare 1.1.1.1 docs
Skip to content
Documentation Index
Fetch the complete documentation index at: https://developers.cloudflare.com/1.1.1.1/llms.txt
Use this file to discover all available pages before exploring further.
Docs
Directory
API
SDKs
Changelog
Search
⌘
K
Log in
Dashboard
1.1.1.1 (DNS Resolver)
/
Overview
IP addresses
Set up
General
Android
Azure
Gaming consoles
Google Cloud
iOS
Linux
macOS
Router
Windows
Encryption
Overview
DNS over TLS
DNS over HTTPS
About DoH
Make API requests to 1.1.1.1
Overview
DNS Wireformat
Using JSON
Configure DoH on your browser
Connect to 1.1.1.1 using DoH clients
Oblivious DoH
DNSKEY
Upstream resolution
Infrastructure
Network operators
Support for IPv6-only networks
Extended DNS error codes
SLA and support
Other ways to use 1.1.1.1
DNS in Google Sheets
DNS over Discord
DNS over Tor
Privacy
Overview
1.1.1.1 Public DNS Resolver
Cloudflare Resolver for Firefox
Verify connection
Troubleshooting
Terms of use
FAQ
Changelog
Agent resources
Agent setup ↗
Cloudflare Skills ↗
Code Mode MCP Server ↗
Domain-specific MCP Servers ↗
MCP
1.1.1.1 llms.txt ↗
1.1.1.1 llms-full.txt ↗
Cloudflare Docs llms.txt ↗
Cloudflare Docs llms-full.txt ↗
Home
/
1.1.1.1 (DNS Resolver)
/
…
Encryption
/
DNS over HTTPS
/
Make API requests to 1.1.1.1
Make API requests to 1.1.1.1
Last updated
May 5, 2026
|
Copy as Markdown
|
View as Markdown
|
Agent setup
Overview
HTTP method
Valid MIME types
Send multiple questions in a query
Authentication
Supported TLS versions
Return codes
Cloudflare offers a DNS over HTTPS resolver at:
https://cloudflare-dns.com/dns-query
HTTP method
Cloudflare's DNS over HTTPS (DoH) endpoint supports
POST
and
GET
for DNS wireformat, and
GET
for JSON format.
When making requests using
POST
, the DNS query is included as the message body of the HTTP request, and the MIME type (
application/dns-message
) is sent in the
Content-Type
request header. Cloudflare will use the message body of the HTTP request as sent by the client, so the message body should not be encoded.
When making requests using
GET
, the DNS query is encoded into the URL.
Valid MIME types
If you use JSON format, set
application/dns-json
, and if you use DNS wireformat, use
application/dns-message
.
Refer to
DNS wireformat
and
JSON
for cURL examples.
Send multiple questions in a query
Each DNS query maps to exactly one HTTP request. To send multiple queries concurrently, use HTTP/2 or HTTP/3, which supports multiplexing multiple requests over a single connection.
HTTP/2 is the minimum recommended version of HTTP for use with DoH. This is not specific to 1.1.1.1, but rather how DoH operates per
RFC 8484
↗
.
Example request:
curl
--http2
--header
"accept: application/dns-json"
"https://one.one.one.one/dns-query?name=cloudflare.com"
--next
--http2
--header
"accept: application/dns-json"
"https://one.one.one.one/dns-query?name=example.com"
Authentication
No authentication is required to send requests to this API.
Supported TLS versions
Cloudflare's DNS over HTTPS resolver supports TLS 1.2 and TLS 1.3.
Return codes
HTTP Status
Meaning
400
DNS query not specified or too small.
413
DNS query is larger than maximum allowed DNS message size.
415
Unsupported content type.
504
Resolver timeout while waiting for the query response.
Previous
About DoH
Next
DNS Wireformat
Was this helpful?
Yes
No
Edit page
Report issue
On this page
Overview
HTTP method
Valid MIME types
Send multiple questions in a query
Authentication
Supported TLS versions
Return codes
Was this helpful?
Yes
No
Edit page
Report issue
Getting started
Plans
Contact sales
Partners
Find a partner
Startups
Under attack?
Domain name search
Company
About
Careers
Investors
Press
Press kit
Global network
Public interest
Project Galileo
Athenian Project
Cloudflare for Campaigns
Project Fairshot
Impact/ESG
Compliance
Compliance resources
Trust Hub
Data Protection
Responsible AI
Transparency report
Report abuse
Resources
App innovation report
Cloudflare Radar
Case studies
Status
Support
Events
Blog
Developers
Documentation
Learning center
Community
Solutions
SSE and SASE platform
Cloudflare AI Cloud
AI Security
Frontend Development Platform
Multi-Tenant Platform Development
Web Security Platform
Start Building
Log In
© 2026 Cloudflare, Inc.
Privacy policy
|
Report security issues
|
Terms of use
|
Trademark
|
Your privacy choices
Docs
