--- title: Get WHOIS Record --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [Intel](https://developers.cloudflare.com/api/python/resources/intel) [Whois](https://developers.cloudflare.com/api/python/resources/intel/subresources/whois) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Get WHOIS Record intel.whois.get(WhoisGetParams\*\*kwargs) -> [WhoisGetResponse]() 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` ##### ParametersExpand Collapse account\_id: str 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)>) domain: Optional\[str] [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
class WhoisGetResponse: … dnssec: bool Link to this property domain: str Link to this property extension: str Link to this property found: bool Link to this property nameservers: List\[str] Link to this property punycode: str Link to this property registrant: str Link to this property registrar: str Link to this property id: Optional\[str] Link to this property administrative\_city: Optional\[str] Link to this property administrative\_country: Optional\[str] Link to this property administrative\_email: Optional\[str] Link to this property administrative\_fax: Optional\[str] Link to this property administrative\_fax\_ext: Optional\[str] Link to this property administrative\_id: Optional\[str] Link to this property administrative\_name: Optional\[str] Link to this property administrative\_org: Optional\[str] Link to this property administrative\_phone: Optional\[str] Link to this property administrative\_phone\_ext: Optional\[str] Link to this property administrative\_postal\_code: Optional\[str] Link to this property administrative\_province: Optional\[str] Link to this property administrative\_referral\_url: Optional\[str] Link to this property administrative\_street: Optional\[str] Link to this property billing\_city: Optional\[str] Link to this property billing\_country: Optional\[str] Link to this property billing\_email: Optional\[str] Link to this property billing\_fax: Optional\[str] Link to this property billing\_fax\_ext: Optional\[str] Link to this property billing\_id: Optional\[str] Link to this property billing\_name: Optional\[str] Link to this property billing\_org: Optional\[str] Link to this property billing\_phone: Optional\[str] Link to this property billing\_phone\_ext: Optional\[str] Link to this property billing\_postal\_code: Optional\[str] Link to this property billing\_province: Optional\[str] Link to this property billing\_referral\_url: Optional\[str] Link to this property billing\_street: Optional\[str] Link to this property created\_date: Optional\[datetime] formatdate-time Link to this property created\_date\_raw: Optional\[str] Link to this property expiration\_date: Optional\[datetime] formatdate-time Link to this property expiration\_date\_raw: Optional\[str] Link to this property registrant\_city: Optional\[str] Link to this property registrant\_country: Optional\[str] Link to this property registrant\_email: Optional\[str] Link to this property registrant\_fax: Optional\[str] Link to this property registrant\_fax\_ext: Optional\[str] Link to this property registrant\_id: Optional\[str] Link to this property registrant\_name: Optional\[str] Link to this property registrant\_org: Optional\[str] Link to this property registrant\_phone: Optional\[str] Link to this property registrant\_phone\_ext: Optional\[str] Link to this property registrant\_postal\_code: Optional\[str] Link to this property registrant\_province: Optional\[str] Link to this property registrant\_referral\_url: Optional\[str] Link to this property registrant\_street: Optional\[str] Link to this property registrar\_city: Optional\[str] Link to this property registrar\_country: Optional\[str] Link to this property registrar\_email: Optional\[str] Link to this property registrar\_fax: Optional\[str] Link to this property registrar\_fax\_ext: Optional\[str] Link to this property registrar\_id: Optional\[str] Link to this property registrar\_name: Optional\[str] Link to this property registrar\_org: Optional\[str] Link to this property registrar\_phone: Optional\[str] Link to this property registrar\_phone\_ext: Optional\[str] Link to this property registrar\_postal\_code: Optional\[str] Link to this property registrar\_province: Optional\[str] Link to this property registrar\_referral\_url: Optional\[str] Link to this property registrar\_street: Optional\[str] Link to this property status: Optional\[List\[str]] Link to this property technical\_city: Optional\[str] Link to this property technical\_country: Optional\[str] Link to this property technical\_email: Optional\[str] Link to this property technical\_fax: Optional\[str] Link to this property technical\_fax\_ext: Optional\[str] Link to this property technical\_id: Optional\[str] Link to this property technical\_name: Optional\[str] Link to this property technical\_org: Optional\[str] Link to this property technical\_phone: Optional\[str] Link to this property technical\_phone\_ext: Optional\[str] Link to this property technical\_postal\_code: Optional\[str] Link to this property technical\_province: Optional\[str] Link to this property technical\_referral\_url: Optional\[str] Link to this property technical\_street: Optional\[str] Link to this property updated\_date: Optional\[datetime] formatdate-time Link to this property updated\_date\_raw: Optional\[str] Link to this property whois\_server: Optional\[str] Link to this property
[Link to this property](<#(resource)%20intel.whois%20%3E%20(model)%20whois_get_response%20%3E%20(schema)>) ### Get WHOIS Record 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 ) whois = client.intel.whois.get( account_id="023e105f4ecef8ad9ca31a8372d0c353", ) print(whois.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" } } ], "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" } } ```