## List origin cloud region mappings

`client.Cache.OriginCloudRegions.List(ctx, params) (*V4PagePaginationArray[OriginCloudRegion], error)`

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

- `params OriginCloudRegionListParams`

  - `ZoneID param.Field[string]`

    Path param: Identifier.

  - `Page param.Field[int64]`

    Query param: Page number of paginated results.

  - `PerPage param.Field[int64]`

    Query param: Number of items per page.

### Returns

- `type OriginCloudRegion struct{…}`

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

  - `OriginIP string`

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

  - `Region string`

    Cloud vendor region identifier.

  - `Vendor OriginCloudRegionVendor`

    Cloud vendor hosting the origin.

    - `const OriginCloudRegionVendorAws OriginCloudRegionVendor = "aws"`

    - `const OriginCloudRegionVendorAzure OriginCloudRegionVendor = "azure"`

    - `const OriginCloudRegionVendorGcp OriginCloudRegionVendor = "gcp"`

    - `const OriginCloudRegionVendorOci OriginCloudRegionVendor = "oci"`

  - `ModifiedOn Time`

    Time this mapping was last modified.

### Example

```go
package main

import (
  "context"
  "fmt"

  "github.com/cloudflare/cloudflare-go"
  "github.com/cloudflare/cloudflare-go/cache"
  "github.com/cloudflare/cloudflare-go/option"
)

func main() {
  client := cloudflare.NewClient(
    option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"),
  )
  page, err := client.Cache.OriginCloudRegions.List(context.TODO(), cache.OriginCloudRegionListParams{
    ZoneID: cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"),
  })
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", page)
}
```

#### Response

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