--- title: List origin cloud region mappings --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api) [Cache](https://developers.cloudflare.com/api/resources/cache) [Origin Cloud Regions](https://developers.cloudflare.com/api/resources/cache/subresources/origin_cloud_regions) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # List origin cloud region mappings GET/zones/{zone\_id}/origin/cloud\_regions Returns all IP-to-cloud-region mappings configured for the zone with pagination support. Each mapping tells Cloudflare which cloud vendor and region hosts the origin at that IP, enabling the edge to route via the nearest Tiered Cache upper-tier co-located with that cloud provider. Returns an empty array when no mappings exist. ##### 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

##### P ath ParametersExpand Collapse zone\_id: string Identifier. maxLength32 [Link to this property](<#(resource)%20cache.origin_cloud_regions%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20zone_id%20%3E%20(schema)>) ##### Q uery ParametersExpand Collapse page: optional number Page number of paginated results. minimum1 [Link to this property](<#(resource)%20cache.origin_cloud_regions%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20page%20%3E%20(schema)>) per\_page: optional number Number of items per page. maximum100 minimum1 [Link to this property](<#(resource)%20cache.origin_cloud_regions%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20per_page%20%3E%20(schema)>) ##### ReturnsExpand Collapse

errors: array of ResponseInfo { 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)%20cache.origin_cloud_regions%20%3E%20(method)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20errors>)

messages: array of ResponseInfo { 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)%20cache.origin_cloud_regions%20%3E%20(method)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20messages>)

result: array of object {origin\_ip, region, vendor, modified\_on }

origin\_ip: string The origin IP address (IPv4 or IPv6). Normalized to canonical form (RFC 5952 for IPv6). Link to this property region: string Cloud vendor region identifier. Link to this property

vendor: "aws"or "azure"or "gcp"or "oci" Cloud vendor hosting the origin.

One of the following: "aws" Link to this property "azure" Link to this property "gcp" Link to this property "oci" Link to this property

Link to this property modified\_on: optional string Time this mapping was last modified. formatdate-time Link to this property

[Link to this property](<#(resource)%20cache.origin_cloud_regions%20%3E%20(method)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20result>)

result\_info: object {count, page, per\_page, 2 more } Pagination metadata for list responses.

count: number Number of items returned in this response. Link to this property page: number Current page number. Link to this property per\_page: number Number of items per page. Link to this property total\_count: number Total number of mappings configured for the zone. Link to this property total\_pages: number Total number of pages. Link to this property

[Link to this property](<#(resource)%20cache.origin_cloud_regions%20%3E%20(method)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20result_info>) success: true Whether the API call was successful. [Link to this property](<#(resource)%20cache.origin_cloud_regions%20%3E%20(method)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20success>) ### List origin cloud region mappings HTTP HTTPTypeScriptPythonGoTerraform ``` curl https://api.cloudflare.com/client/v4/zones/$ZONE_ID/origin/cloud_regions \ -H "Authorization: Bearer $CLOUDFLARE_API_TOKEN" ``` 200 example 200 example 4XX example ``` { "errors": [], "messages": [], "result": [], "result_info": { "count": 0, "page": 1, "per_page": 20, "total_count": 0, "total_pages": 0 }, "success": true } ``` ``` { "errors": [], "messages": [], "result": [ { "modified_on": "2026-03-01T12:00:00Z", "origin_ip": "192.0.2.1", "region": "us-east-1", "vendor": "aws" }, { "modified_on": "2026-03-01T12:30:00Z", "origin_ip": "2001:db8::1", "region": "us-central1", "vendor": "gcp" } ], "result_info": { "count": 2, "page": 1, "per_page": 20, "total_count": 2, "total_pages": 1 }, "success": true } ``` ``` { "errors": [ { "code": 1146, "message": "invalid per_page parameter, must be between 1 and 100" } ], "messages": [], "result": null, "success": false } ``` ##### Returns Examples 200 example 200 example 4XX example ``` { "errors": [], "messages": [], "result": [], "result_info": { "count": 0, "page": 1, "per_page": 20, "total_count": 0, "total_pages": 0 }, "success": true } ``` ``` { "errors": [], "messages": [], "result": [ { "modified_on": "2026-03-01T12:00:00Z", "origin_ip": "192.0.2.1", "region": "us-east-1", "vendor": "aws" }, { "modified_on": "2026-03-01T12:30:00Z", "origin_ip": "2001:db8::1", "region": "us-central1", "vendor": "gcp" } ], "result_info": { "count": 2, "page": 1, "per_page": 20, "total_count": 2, "total_pages": 1 }, "success": true } ``` ``` { "errors": [ { "code": 1146, "message": "invalid per_page parameter, must be between 1 and 100" } ], "messages": [], "result": null, "success": false } ```