--- title: Get WHOIS Record --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api) [Intel](https://developers.cloudflare.com/api/resources/intel) [Whois](https://developers.cloudflare.com/api/resources/intel/subresources/whois) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Get WHOIS Record GET/accounts/{account\_id}/intel/whois Retrieves WHOIS registration data for a domain, including registrant and nameserver information. ##### 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) `Intel Write``Intel Read` ##### P ath ParametersExpand Collapse account\_id: string Use to uniquely identify or reference the resource. maxLength32 [Link to this property](<#(resource)%20intel.whois%20%3E%20(method)%20get%20%3E%20(params)%20default%20%3E%20(param)%20account_id%20%3E%20(schema)>) ##### Q uery ParametersExpand Collapse domain: optional string [Link to this property](<#(resource)%20intel.whois%20%3E%20(method)%20get%20%3E%20(params)%20default%20%3E%20(param)%20domain%20%3E%20(schema)>) ##### ReturnsExpand Collapse

errors: array of object {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)%20intel.whois%20%3E%20(method)%20get%20%3E%20(network%20schema)%20%3E%20(property)%20errors>)

messages: array of object {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)%20intel.whois%20%3E%20(method)%20get%20%3E%20(network%20schema)%20%3E%20(property)%20messages>) success: true Returns a boolean for the success/failure of the API call. [Link to this property](<#(resource)%20intel.whois%20%3E%20(method)%20get%20%3E%20(network%20schema)%20%3E%20(property)%20success>)

result: optional object {dnssec, domain, extension, 84 more }

dnssec: boolean Link to this property domain: string Link to this property extension: string Link to this property found: boolean Link to this property nameservers: array of string Link to this property punycode: string Link to this property registrant: string Link to this property registrar: string Link to this property id: optional string Link to this property administrative\_city: optional string Link to this property administrative\_country: optional string Link to this property administrative\_email: optional string Link to this property administrative\_fax: optional string Link to this property administrative\_fax\_ext: optional string Link to this property administrative\_id: optional string Link to this property administrative\_name: optional string Link to this property administrative\_org: optional string Link to this property administrative\_phone: optional string Link to this property administrative\_phone\_ext: optional string Link to this property administrative\_postal\_code: optional string Link to this property administrative\_province: optional string Link to this property administrative\_referral\_url: optional string Link to this property administrative\_street: optional string Link to this property billing\_city: optional string Link to this property billing\_country: optional string Link to this property billing\_email: optional string Link to this property billing\_fax: optional string Link to this property billing\_fax\_ext: optional string Link to this property billing\_id: optional string Link to this property billing\_name: optional string Link to this property billing\_org: optional string Link to this property billing\_phone: optional string Link to this property billing\_phone\_ext: optional string Link to this property billing\_postal\_code: optional string Link to this property billing\_province: optional string Link to this property billing\_referral\_url: optional string Link to this property billing\_street: optional string Link to this property created\_date: optional string formatdate-time Link to this property created\_date\_raw: optional string Link to this property expiration\_date: optional string formatdate-time Link to this property expiration\_date\_raw: optional string Link to this property registrant\_city: optional string Link to this property registrant\_country: optional string Link to this property registrant\_email: optional string Link to this property registrant\_fax: optional string Link to this property registrant\_fax\_ext: optional string Link to this property registrant\_id: optional string Link to this property registrant\_name: optional string Link to this property registrant\_org: optional string Link to this property registrant\_phone: optional string Link to this property registrant\_phone\_ext: optional string Link to this property registrant\_postal\_code: optional string Link to this property registrant\_province: optional string Link to this property registrant\_referral\_url: optional string Link to this property registrant\_street: optional string Link to this property registrar\_city: optional string Link to this property registrar\_country: optional string Link to this property registrar\_email: optional string Link to this property registrar\_fax: optional string Link to this property registrar\_fax\_ext: optional string Link to this property registrar\_id: optional string Link to this property registrar\_name: optional string Link to this property registrar\_org: optional string Link to this property registrar\_phone: optional string Link to this property registrar\_phone\_ext: optional string Link to this property registrar\_postal\_code: optional string Link to this property registrar\_province: optional string Link to this property registrar\_referral\_url: optional string Link to this property registrar\_street: optional string Link to this property status: optional array of string Link to this property technical\_city: optional string Link to this property technical\_country: optional string Link to this property technical\_email: optional string Link to this property technical\_fax: optional string Link to this property technical\_fax\_ext: optional string Link to this property technical\_id: optional string Link to this property technical\_name: optional string Link to this property technical\_org: optional string Link to this property technical\_phone: optional string Link to this property technical\_phone\_ext: optional string Link to this property technical\_postal\_code: optional string Link to this property technical\_province: optional string Link to this property technical\_referral\_url: optional string Link to this property technical\_street: optional string Link to this property updated\_date: optional string formatdate-time Link to this property updated\_date\_raw: optional string Link to this property whois\_server: optional string Link to this property

[Link to this property](<#(resource)%20intel.whois%20%3E%20(method)%20get%20%3E%20(network%20schema)%20%3E%20(property)%20result>) ### Get WHOIS Record HTTP HTTPTypeScriptPythonGoTerraform ``` curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/intel/whois \ -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" } } ], "success": true, "result": { "dnssec": true, "domain": "cloudflare.com", "extension": "com", "found": true, "nameservers": [ "ns3.cloudflare.com", "ns4.cloudflare.com", "ns5.cloudflare.com", "ns6.cloudflare.com", "ns7.cloudflare.com" ], "punycode": "cloudflare.com", "registrant": "registrant", "registrar": "Cloudflare, Inc.", "id": "1542998887_DOMAIN_COM-VRSN", "administrative_city": "administrative_city", "administrative_country": "administrative_country", "administrative_email": "administrative_email", "administrative_fax": "administrative_fax", "administrative_fax_ext": "administrative_fax_ext", "administrative_id": "administrative_id", "administrative_name": "administrative_name", "administrative_org": "administrative_org", "administrative_phone": "administrative_phone", "administrative_phone_ext": "administrative_phone_ext", "administrative_postal_code": "administrative_postal_code", "administrative_province": "administrative_province", "administrative_referral_url": "administrative_referral_url", "administrative_street": "administrative_street", "billing_city": "billing_city", "billing_country": "billing_country", "billing_email": "billing_email", "billing_fax": "billing_fax", "billing_fax_ext": "billing_fax_ext", "billing_id": "billing_id", "billing_name": "billing_name", "billing_org": "billing_org", "billing_phone": "billing_phone", "billing_phone_ext": "billing_phone_ext", "billing_postal_code": "billing_postal_code", "billing_province": "billing_province", "billing_referral_url": "billing_referral_url", "billing_street": "billing_street", "created_date": "2009-02-17T22:07:54Z", "created_date_raw": "2009-02-17T22:07:54Z", "expiration_date": "2033-02-17T22:07:54Z", "expiration_date_raw": "2033-02-17T22:07:54Z", "registrant_city": "registrant_city", "registrant_country": "registrant_country", "registrant_email": "registrant_email", "registrant_fax": "registrant_fax", "registrant_fax_ext": "registrant_fax_ext", "registrant_id": "registrant_id", "registrant_name": "registrant_name", "registrant_org": "registrant_org", "registrant_phone": "registrant_phone", "registrant_phone_ext": "registrant_phone_ext", "registrant_postal_code": "registrant_postal_code", "registrant_province": "registrant_province", "registrant_referral_url": "registrant_referral_url", "registrant_street": "registrant_street", "registrar_city": "registrar_city", "registrar_country": "registrar_country", "registrar_email": "registrar_email", "registrar_fax": "registrar_fax", "registrar_fax_ext": "registrar_fax_ext", "registrar_id": "registrar_id", "registrar_name": "registrar_name", "registrar_org": "registrar_org", "registrar_phone": "registrar_phone", "registrar_phone_ext": "registrar_phone_ext", "registrar_postal_code": "registrar_postal_code", "registrar_province": "registrar_province", "registrar_referral_url": "registrar_referral_url", "registrar_street": "registrar_street", "status": [ "clientdeleteprohibited", "clienttransferprohibited", "clientupdateprohibited", "serverdeleteprohibited", "servertransferprohibited", "serverupdateprohibited" ], "technical_city": "technical_city", "technical_country": "technical_country", "technical_email": "technical_email", "technical_fax": "technical_fax", "technical_fax_ext": "technical_fax_ext", "technical_id": "technical_id", "technical_name": "technical_name", "technical_org": "technical_org", "technical_phone": "technical_phone", "technical_phone_ext": "technical_phone_ext", "technical_postal_code": "technical_postal_code", "technical_province": "technical_province", "technical_referral_url": "technical_referral_url", "technical_street": "technical_street", "updated_date": "2024-01-09T16:45:28Z", "updated_date_raw": "2024-01-09T16:45:28Z", "whois_server": "whois.cloudflare.com" } } ``` ##### 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" } } ], "success": true, "result": { "dnssec": true, "domain": "cloudflare.com", "extension": "com", "found": true, "nameservers": [ "ns3.cloudflare.com", "ns4.cloudflare.com", "ns5.cloudflare.com", "ns6.cloudflare.com", "ns7.cloudflare.com" ], "punycode": "cloudflare.com", "registrant": "registrant", "registrar": "Cloudflare, Inc.", "id": "1542998887_DOMAIN_COM-VRSN", "administrative_city": "administrative_city", "administrative_country": "administrative_country", "administrative_email": "administrative_email", "administrative_fax": "administrative_fax", "administrative_fax_ext": "administrative_fax_ext", "administrative_id": "administrative_id", "administrative_name": "administrative_name", "administrative_org": "administrative_org", "administrative_phone": "administrative_phone", "administrative_phone_ext": "administrative_phone_ext", "administrative_postal_code": "administrative_postal_code", "administrative_province": "administrative_province", "administrative_referral_url": "administrative_referral_url", "administrative_street": "administrative_street", "billing_city": "billing_city", "billing_country": "billing_country", "billing_email": "billing_email", "billing_fax": "billing_fax", "billing_fax_ext": "billing_fax_ext", "billing_id": "billing_id", "billing_name": "billing_name", "billing_org": "billing_org", "billing_phone": "billing_phone", "billing_phone_ext": "billing_phone_ext", "billing_postal_code": "billing_postal_code", "billing_province": "billing_province", "billing_referral_url": "billing_referral_url", "billing_street": "billing_street", "created_date": "2009-02-17T22:07:54Z", "created_date_raw": "2009-02-17T22:07:54Z", "expiration_date": "2033-02-17T22:07:54Z", "expiration_date_raw": "2033-02-17T22:07:54Z", "registrant_city": "registrant_city", "registrant_country": "registrant_country", "registrant_email": "registrant_email", "registrant_fax": "registrant_fax", "registrant_fax_ext": "registrant_fax_ext", "registrant_id": "registrant_id", "registrant_name": "registrant_name", "registrant_org": "registrant_org", "registrant_phone": "registrant_phone", "registrant_phone_ext": "registrant_phone_ext", "registrant_postal_code": "registrant_postal_code", "registrant_province": "registrant_province", "registrant_referral_url": "registrant_referral_url", "registrant_street": "registrant_street", "registrar_city": "registrar_city", "registrar_country": "registrar_country", "registrar_email": "registrar_email", "registrar_fax": "registrar_fax", "registrar_fax_ext": "registrar_fax_ext", "registrar_id": "registrar_id", "registrar_name": "registrar_name", "registrar_org": "registrar_org", "registrar_phone": "registrar_phone", "registrar_phone_ext": "registrar_phone_ext", "registrar_postal_code": "registrar_postal_code", "registrar_province": "registrar_province", "registrar_referral_url": "registrar_referral_url", "registrar_street": "registrar_street", "status": [ "clientdeleteprohibited", "clienttransferprohibited", "clientupdateprohibited", "serverdeleteprohibited", "servertransferprohibited", "serverupdateprohibited" ], "technical_city": "technical_city", "technical_country": "technical_country", "technical_email": "technical_email", "technical_fax": "technical_fax", "technical_fax_ext": "technical_fax_ext", "technical_id": "technical_id", "technical_name": "technical_name", "technical_org": "technical_org", "technical_phone": "technical_phone", "technical_phone_ext": "technical_phone_ext", "technical_postal_code": "technical_postal_code", "technical_province": "technical_province", "technical_referral_url": "technical_referral_url", "technical_street": "technical_street", "updated_date": "2024-01-09T16:45:28Z", "updated_date_raw": "2024-01-09T16:45:28Z", "whois_server": "whois.cloudflare.com" } } ```