> This page is for Developers.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.iot.telia.lt/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.iot.telia.lt/_mcp/server.

# Get list of available Cloud Connect regions by breakout type

GET https://iot.telia.lt/api/v1/cnc/breakout_type/{breakout_type_id}/available_region

Returns a list of regions available for use when creating new Cloud Connect breakouts of the selected breakout type.

If the attachment region is peered to another one, the device breakout region will also be returned.


Reference: https://docs.iot.telia.lt/developers/api/cloud-connect/get-cloud-connect-available-regions-by-breakout-type

## Authentication

- `Authorization` header (bearer token, required) — An `auth_token` should be provided to authenticate a session. To obtain an `auth_token`, see the [`/api/v1/authenticate` **POST** request](/developers/api/authentication/authenticate).

## Request

### Path parameters

- `breakout_type_id` (integer, required) — ID of a Cloud Connect breakout type. Possible values can be retrieved with `GET /api/v1/cnc/breakout_type`.

## Response

### 200

Success

- `list of ApiV1CncBreakoutTypeBreakoutTypeIdAvailableRegionGetResponsesContentApplicationJsonSchemaItems`

## Errors

### 403 Forbidden Error

Your role doesn't include the permission this endpoint requires. Most endpoints return `error_code`, `error_token`, and `message`. Some return only `status_code` and `message`.

- `error_code` (integer, optional)
- `error_token` (string, optional)
- `status_code` (integer, optional)
- `message` (string, optional)

## Types

### ApiV1CncBreakoutTypeBreakoutTypeIdAvailableRegionGetResponsesContentApplicationJsonSchemaItems

- `attachment_region` (string, optional) — The region the customer's attachment will reside in
- `device_breakout_region` (string, optional) — The region the traffic will be peered to

## Examples

**Response**

```json
[
  {
    "attachment_region": "eu-west-1"
  },
  {
    "attachment_region": "eu-central-1",
    "device_breakout_region": "eu-west-1"
  }
]
```

**SDK Code**

```python Available Regions
import requests

url = "https://iot.telia.lt/api/v1/cnc/breakout_type/1/available_region"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.json())
```

```javascript Available Regions
const url = 'https://iot.telia.lt/api/v1/cnc/breakout_type/1/available_region';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go Available Regions
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://iot.telia.lt/api/v1/cnc/breakout_type/1/available_region"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby Available Regions
require 'uri'
require 'net/http'

url = URI("https://iot.telia.lt/api/v1/cnc/breakout_type/1/available_region")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body
```

```java Available Regions
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.get("https://iot.telia.lt/api/v1/cnc/breakout_type/1/available_region")
  .header("Authorization", "Bearer <token>")
  .asString();
```

```php Available Regions
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://iot.telia.lt/api/v1/cnc/breakout_type/1/available_region', [
  'headers' => [
    'Authorization' => 'Bearer <token>',
  ],
]);

echo $response->getBody();
```

```csharp Available Regions
using RestSharp;

var client = new RestClient("https://iot.telia.lt/api/v1/cnc/breakout_type/1/available_region");
var request = new RestRequest(Method.GET);
request.AddHeader("Authorization", "Bearer <token>");
IRestResponse response = client.Execute(request);
```

```swift Available Regions
import Foundation

let headers = ["Authorization": "Bearer <token>"]

let request = NSMutableURLRequest(url: NSURL(string: "https://iot.telia.lt/api/v1/cnc/breakout_type/1/available_region")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "GET"
request.allHTTPHeaderFields = headers

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```