# Connectivity


The read-only network catalog for the `Connectivity` dataset on
[Create Audience](/api/v2/audiences#post-apiv2analysesaudiencescreate): the home
internet networks and mobile carriers a `Connectivity` block can name. The
dataset is available on request.

Every read here is authenticated and JSON-only (bearer token + `Accept:
application/json`) and uses the read rate bucket (120 requests/min per caller).

## Get Connectivity Networks {#get-apiv2analysesreferenceconnectivitynetworks}

`GET /api/v2/analyses/reference/connectivity/networks`

The network brands a `Connectivity` dataset can name in `connectivity_networks`, by kind. Each row carries the technologies of a home network. The list holds curated brands only. To read any home network, or any mobile carrier, leave `connectivity_networks` empty. That includes networks that are not in the list. The list is paginated. Before the first weekly catalog is published the list is empty, and creates are refused with "Connectivity data is not available yet."

**Auth:** bearer token + `Accept: application/json`. Rate limit: read bucket
(120 requests/min).

### Query parameters

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `kind` | string | No | `home` or `mobile`. Both kinds are returned when left out. |
| `search` | string | No | Optional free-text filter on the network name (case-insensitive contains). |
| `page` | integer | No | Page number, starting at 1. |
| `per_page` | integer | No | Items per page, up to 500 (default 500). |

{{< tabs >}}

  {{< tab name="cURL" >}}
  ```bash
  curl "https://console.intuizi.com/api/v2/analyses/reference/connectivity/networks?kind=home&search=star" \
    -H "Authorization: Bearer <YOUR_TOKEN>" \
    -H "Accept: application/json"
  ```
  {{< /tab >}}

  {{< tab name="Python" >}}
  ```python
  import requests

  res = requests.get(
      "https://console.intuizi.com/api/v2/analyses/reference/connectivity/networks",
      params={"kind": "home", "search": "star"},
      headers={"Authorization": "Bearer <YOUR_TOKEN>", "Accept": "application/json"},
  )
  networks = [row["value"] for row in res.json()["data"]["items"]]
  ```
  {{< /tab >}}

  {{< tab name="JavaScript" >}}
  ```javascript
  const res = await fetch(
    "https://console.intuizi.com/api/v2/analyses/reference/connectivity/networks?kind=home&search=star",
    { headers: { Authorization: "Bearer <YOUR_TOKEN>", Accept: "application/json" } }
  );
  const networks = (await res.json()).data.items.map((row) => row.value);
  ```
  {{< /tab >}}

  {{< tab name="PHP" >}}
  ```php
  $res = Http::withToken('<YOUR_TOKEN>')->acceptJson()
      ->get('https://console.intuizi.com/api/v2/analyses/reference/connectivity/networks', [
          'kind' => 'home',
          'search' => 'star',
      ]);
  $networks = collect($res->json('data.items'))->pluck('value');
  ```
  {{< /tab >}}

{{< /tabs >}}

### Response

Each item has a `value` (the name to put in `connectivity_networks`), a `text` label, its `kind` and its `technologies`. Technologies are home only, so the list is always empty for a mobile carrier.

```json
{
  "status": "success",
  "code": 200,
  "message": "Resources fetched successfully.",
  "data": {
    "items": [
      { "value": "Starlink", "text": "Starlink", "kind": "home", "technologies": ["Satellite"] },
      { "value": "Starry", "text": "Starry", "kind": "home", "technologies": ["Fixed wireless"] }
    ],
    "pagination": { "current_page": 1, "per_page": 500, "total": 2, "last_page": 1 }
  }
}
```
