## List origin cloud region mappings

`cache.origin_cloud_regions.list(OriginCloudRegionListParams**kwargs)  -> OriginCloudRegionListResponse`

**get** `/zones/{zone_id}/cache/origin_cloud_regions`

Returns all IP-to-cloud-region mappings configured for the zone. 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.

### Returns

- `class OriginCloudRegionListResponse: …`

  Response result for a list of origin cloud region mappings.

  - `id: Literal["origin_public_cloud_region"]`

    - `"origin_public_cloud_region"`

  - `editable: bool`

    Whether the setting can be modified by the current user.

  - `value: List[OriginCloudRegion]`

    - `origin_ip: str`

      The origin IP address (IPv4 or IPv6, canonicalized).

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

  - `modified_on: Optional[datetime]`

    Time the mapping set was last modified. Null when no mappings exist.

### 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
)
origin_cloud_regions = client.cache.origin_cloud_regions.list(
    zone_id="023e105f4ecef8ad9ca31a8372d0c353",
)
print(origin_cloud_regions.id)
```

#### Response

```json
{
  "errors": [],
  "messages": [],
  "result": {
    "editable": true,
    "id": "origin_public_cloud_region",
    "modified_on": null,
    "value": []
  },
  "success": true
}
```