---
title: Regional Hostnames
---

[Skip to content](#%5Ftop) 

[API Reference](https://developers.cloudflare.com/api/typescript)

[Addressing](https://developers.cloudflare.com/api/typescript/resources/addressing)

Copy Markdown

Open in **Claude**

Open in **ChatGPT**

Open in **Cursor**

---

**Copy Markdown**

**View as Markdown**

# Regional Hostnames

##### [List Regional Hostnames](https://developers.cloudflare.com/api/typescript/resources/addressing/subresources/regional%5Fhostnames/methods/list)

client.addressing.regionalHostnames.list(RegionalHostnameListParams { zone\_id } params, RequestOptionsoptions?): SinglePage<[RegionalHostnameListResponse](https://developers.cloudflare.com/api/typescript/resources/addressing#%28resource%29%20addressing.regional%5Fhostnames%20%3E%20%28model%29%20regional%5Fhostname%5Flist%5Fresponse%20%3E%20%28schema%29) { created\_on, hostname, region\_key, routing } \>

GET/zones/{zone\_id}/addressing/regional\_hostnames

##### [Fetch Regional Hostname](https://developers.cloudflare.com/api/typescript/resources/addressing/subresources/regional%5Fhostnames/methods/get)

client.addressing.regionalHostnames.get(stringhostname, RegionalHostnameGetParams { zone\_id } params, RequestOptionsoptions?): [RegionalHostnameGetResponse](https://developers.cloudflare.com/api/typescript/resources/addressing#%28resource%29%20addressing.regional%5Fhostnames%20%3E%20%28model%29%20regional%5Fhostname%5Fget%5Fresponse%20%3E%20%28schema%29) { created\_on, hostname, region\_key, routing } 

GET/zones/{zone\_id}/addressing/regional\_hostnames/{hostname}

##### [Create Regional Hostname](https://developers.cloudflare.com/api/typescript/resources/addressing/subresources/regional%5Fhostnames/methods/create)

client.addressing.regionalHostnames.create(RegionalHostnameCreateParams { zone\_id, hostname, region\_key, routing } params, RequestOptionsoptions?): [RegionalHostnameCreateResponse](https://developers.cloudflare.com/api/typescript/resources/addressing#%28resource%29%20addressing.regional%5Fhostnames%20%3E%20%28model%29%20regional%5Fhostname%5Fcreate%5Fresponse%20%3E%20%28schema%29) { created\_on, hostname, region\_key, routing } 

POST/zones/{zone\_id}/addressing/regional\_hostnames

##### [Update Regional Hostname](https://developers.cloudflare.com/api/typescript/resources/addressing/subresources/regional%5Fhostnames/methods/edit)

client.addressing.regionalHostnames.edit(stringhostname, RegionalHostnameEditParams { zone\_id, region\_key } params, RequestOptionsoptions?): [RegionalHostnameEditResponse](https://developers.cloudflare.com/api/typescript/resources/addressing#%28resource%29%20addressing.regional%5Fhostnames%20%3E%20%28model%29%20regional%5Fhostname%5Fedit%5Fresponse%20%3E%20%28schema%29) { created\_on, hostname, region\_key, routing } 

PATCH/zones/{zone\_id}/addressing/regional\_hostnames/{hostname}

##### [Delete Regional Hostname](https://developers.cloudflare.com/api/typescript/resources/addressing/subresources/regional%5Fhostnames/methods/delete)

client.addressing.regionalHostnames.delete(stringhostname, RegionalHostnameDeleteParams { zone\_id } params, RequestOptionsoptions?): [RegionalHostnameDeleteResponse](https://developers.cloudflare.com/api/typescript/resources/addressing#%28resource%29%20addressing.regional%5Fhostnames%20%3E%20%28model%29%20regional%5Fhostname%5Fdelete%5Fresponse%20%3E%20%28schema%29) { errors, messages, success } 

DELETE/zones/{zone\_id}/addressing/regional\_hostnames/{hostname}

##### ModelsExpand Collapse 

RegionalHostnameListResponse { created\_on, hostname, region\_key, routing } 

created\_on: string

When the regional hostname was created

formatdate-time

hostname: string

DNS hostname to be regionalized, must be a subdomain of the zone. Wildcards are supported for one level, e.g `*.example.com`

region\_key: string

Identifying key for the region

routing: string

Configure which routing method to use for the regional hostname

RegionalHostnameGetResponse { created\_on, hostname, region\_key, routing } 

created\_on: string

When the regional hostname was created

formatdate-time

hostname: string

DNS hostname to be regionalized, must be a subdomain of the zone. Wildcards are supported for one level, e.g `*.example.com`

region\_key: string

Identifying key for the region

routing: string

Configure which routing method to use for the regional hostname

RegionalHostnameCreateResponse { created\_on, hostname, region\_key, routing } 

created\_on: string

When the regional hostname was created

formatdate-time

hostname: string

DNS hostname to be regionalized, must be a subdomain of the zone. Wildcards are supported for one level, e.g `*.example.com`

region\_key: string

Identifying key for the region

routing: string

Configure which routing method to use for the regional hostname

RegionalHostnameEditResponse { created\_on, hostname, region\_key, routing } 

created\_on: string

When the regional hostname was created

formatdate-time

hostname: string

DNS hostname to be regionalized, must be a subdomain of the zone. Wildcards are supported for one level, e.g `*.example.com`

region\_key: string

Identifying key for the region

routing: string

Configure which routing method to use for the regional hostname

RegionalHostnameDeleteResponse { errors, messages, success } 

errors: Array<Error\>

code: number

minimum1000

message: string

documentation\_url?: string

source?: Source { pointer } 

pointer?: string

messages: Array<Message\>

code: number

minimum1000

message: string

documentation\_url?: string

source?: Source { pointer } 

pointer?: string

success: true

Whether the API call was successful.

#### Regional HostnamesRegions

##### [List Regions](https://developers.cloudflare.com/api/typescript/resources/addressing/subresources/regional%5Fhostnames/subresources/regions/methods/list)

client.addressing.regionalHostnames.regions.list(RegionListParams { account\_id } params, RequestOptionsoptions?): SinglePage<[RegionListResponse](https://developers.cloudflare.com/api/typescript/resources/addressing#%28resource%29%20addressing.regional%5Fhostnames.regions%20%3E%20%28model%29%20region%5Flist%5Fresponse%20%3E%20%28schema%29) { key, label } \>

GET/accounts/{account\_id}/addressing/regional\_hostnames/regions

##### ModelsExpand Collapse 

RegionListResponse { key, label } 

key?: string

Identifying key for the region

label?: string

Human-readable text label for the region