## List origin cloud region mappings

`cache.origin_cloud_regions.list(OriginCloudRegionListParams**kwargs)  -> SyncV4PagePaginationArray[OriginCloudRegion]`

**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.

### Parameters

- `zone_id: str`

  Identifier.

- `page: Optional[int]`

  Page number of paginated results.

- `per_page: Optional[int]`

  Number of items per page.

### Returns

- `class OriginCloudRegion: …`

  A single origin IP-to-cloud-region mapping.

  - `origin_ip: str`

    The origin IP address (IPv4 or IPv6). Normalized to canonical form (RFC 5952 for IPv6).

  - `region: str`

    Cloud vendor region identifier.

  - `vendor: Literal["aws", "azure", "gcp", "oci"]`

    Cloud vendor hosting the origin.

    - `"aws"`

    - `"azure"`

    - `"gcp"`

    - `"oci"`

  - `modified_on: Optional[datetime]`

    Time this mapping was last modified.

### Example

```python
import os
from cloudflare import Cloudflare

client = Cloudflare(
    api_token=os.environ.get("CLOUDFLARE_API_TOKEN"),  # This is the default and can be omitted
)
page = client.cache.origin_cloud_regions.list(
    zone_id="023e105f4ecef8ad9ca31a8372d0c353",
)
page = page.result[0]
print(page.origin_ip)
```

#### Response

```json
{
  "errors": [],
  "messages": [],
  "result": [],
  "result_info": {
    "count": 0,
    "page": 1,
    "per_page": 20,
    "total_count": 0,
    "total_pages": 0
  },
  "success": true
}
```