# Regions

## List Regions

`client.LoadBalancers.Regions.List(ctx, params) (*unknown, error)`

**get** `/accounts/{account_id}/load_balancers/regions`

List all region mappings.

### Parameters

- `params RegionListParams`

  - `AccountID param.Field[string]`

    Path param: Identifier.

  - `CountryCodeA2 param.Field[string]`

    Query param: Two-letter alpha-2 country code followed in ISO 3166-1.

  - `SubdivisionCode param.Field[string]`

    Query param: Two-letter subdivision code followed in ISO 3166-2.

  - `SubdivisionCodeA2 param.Field[string]`

    Query param: Two-letter subdivision code followed in ISO 3166-2.

### Returns

- `type RegionListResponseEnvelopeResult interface{…}`

  - `unknown`

### Example

```go
package main

import (
  "context"
  "fmt"

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

func main() {
  client := cloudflare.NewClient(
    option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"),
  )
  regions, err := client.LoadBalancers.Regions.List(context.TODO(), load_balancers.RegionListParams{
    AccountID: cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"),
  })
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", regions)
}
```

#### Response

```json
{
  "errors": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "messages": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "result": {},
  "success": true
}
```

## Get Region

`client.LoadBalancers.Regions.Get(ctx, regionID, query) (*unknown, error)`

**get** `/accounts/{account_id}/load_balancers/regions/{region_id}`

Get a single region mapping.

### Parameters

- `regionID RegionGetParamsRegionID`

  A list of Cloudflare regions. WNAM: Western North America, ENAM: Eastern North America, WEU: Western Europe, EEU: Eastern Europe, NSAM: Northern South America, SSAM: Southern South America, OC: Oceania, ME: Middle East, NAF: North Africa, SAF: South Africa, SAS: Southern Asia, SEAS: South East Asia, NEAS: North East Asia).

  - `const RegionGetParamsRegionIDWnam RegionGetParamsRegionID = "WNAM"`

  - `const RegionGetParamsRegionIDEnam RegionGetParamsRegionID = "ENAM"`

  - `const RegionGetParamsRegionIDWeu RegionGetParamsRegionID = "WEU"`

  - `const RegionGetParamsRegionIDEeu RegionGetParamsRegionID = "EEU"`

  - `const RegionGetParamsRegionIDNsam RegionGetParamsRegionID = "NSAM"`

  - `const RegionGetParamsRegionIDSsam RegionGetParamsRegionID = "SSAM"`

  - `const RegionGetParamsRegionIDOc RegionGetParamsRegionID = "OC"`

  - `const RegionGetParamsRegionIDMe RegionGetParamsRegionID = "ME"`

  - `const RegionGetParamsRegionIDNaf RegionGetParamsRegionID = "NAF"`

  - `const RegionGetParamsRegionIDSaf RegionGetParamsRegionID = "SAF"`

  - `const RegionGetParamsRegionIDSas RegionGetParamsRegionID = "SAS"`

  - `const RegionGetParamsRegionIDSeas RegionGetParamsRegionID = "SEAS"`

  - `const RegionGetParamsRegionIDNeas RegionGetParamsRegionID = "NEAS"`

- `query RegionGetParams`

  - `AccountID param.Field[string]`

    Identifier.

### Returns

- `type RegionGetResponseEnvelopeResult interface{…}`

  A list of countries and subdivisions mapped to a region.

  - `unknown`

### Example

```go
package main

import (
  "context"
  "fmt"

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

func main() {
  client := cloudflare.NewClient(
    option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"),
  )
  region, err := client.LoadBalancers.Regions.Get(
    context.TODO(),
    load_balancers.RegionGetParamsRegionIDWnam,
    load_balancers.RegionGetParams{
      AccountID: cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"),
    },
  )
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", region)
}
```

#### Response

```json
{
  "errors": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "messages": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "result": {
    "iso_standard": "Country and subdivision codes follow ISO 3166-1 alpha-2 and ISO 3166-2",
    "regions": [
      {
        "countries": [
          {
            "country_code_a2": "CA",
            "country_name": "Canada",
            "country_subdivisions": [
              {
                "subdivision_code_a2": "AB",
                "subdivision_name": "Alberta"
              },
              {
                "subdivision_code_a2": "BC",
                "subdivision_name": "British Columbia"
              }
            ]
          },
          {
            "country_code_a2": "HT",
            "country_name": "Haiti"
          },
          {
            "country_code_a2": "MX",
            "country_name": "Mexico"
          },
          {
            "country_code_a2": "US",
            "country_name": "United States",
            "country_subdivisions": [
              {
                "subdivision_code_a2": "AZ",
                "subdivision_name": "Arizona"
              },
              {
                "subdivision_code_a2": "CA",
                "subdivision_name": "California"
              },
              {
                "subdivision_code_a2": "CO",
                "subdivision_name": "Colorado"
              },
              {
                "subdivision_code_a2": "HI",
                "subdivision_name": "Hawaii"
              },
              {
                "subdivision_code_a2": "MN",
                "subdivision_name": "Minnesota"
              },
              {
                "subdivision_code_a2": "MO",
                "subdivision_name": "Missouri"
              },
              {
                "subdivision_code_a2": "NV",
                "subdivision_name": "Nevada"
              },
              {
                "subdivision_code_a2": "OR",
                "subdivision_name": "Oregon"
              },
              {
                "subdivision_code_a2": "TX",
                "subdivision_name": "Texas"
              },
              {
                "subdivision_code_a2": "UT",
                "subdivision_name": "Utah"
              },
              {
                "subdivision_code_a2": "WA",
                "subdivision_name": "Washington"
              }
            ]
          }
        ],
        "region_code": "WNAM"
      }
    ]
  },
  "success": true
}
```