# Slots

## Retrieve a list of all slots matching the specified parameters

`network_interconnects.slots.list(SlotListParams**kwargs)  -> SlotListResponse`

**get** `/accounts/{account_id}/cni/slots`

Retrieve a list of all slots matching the specified parameters

### Parameters

- `account_id: str`

  Customer account tag

- `address_contains: Optional[str]`

  If specified, only show slots with the given text in their address field

- `cursor: Optional[int]`

- `limit: Optional[int]`

- `occupied: Optional[bool]`

  If specified, only show slots with a specific occupied/unoccupied state

- `site: Optional[str]`

  If specified, only show slots located at the given site

- `speed: Optional[str]`

  If specified, only show slots that support the given speed

### Returns

- `class SlotListResponse: …`

  - `items: List[Item]`

    - `id: str`

      Slot ID

    - `facility: ItemFacility`

      - `address: List[str]`

      - `name: str`

    - `occupied: bool`

      Whether the slot is occupied or not

    - `site: str`

    - `speed: str`

    - `account: Optional[str]`

      Customer account tag

  - `next: Optional[int]`

### 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
)
slots = client.network_interconnects.slots.list(
    account_id="account_id",
)
print(slots.items)
```

#### Response

```json
{
  "items": [
    {
      "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
      "facility": {
        "address": [
          "string"
        ],
        "name": "name"
      },
      "occupied": true,
      "site": "site",
      "speed": "speed",
      "account": "account"
    }
  ],
  "next": 0
}
```

## Get information about the specified slot

`network_interconnects.slots.get(strslot, SlotGetParams**kwargs)  -> SlotGetResponse`

**get** `/accounts/{account_id}/cni/slots/{slot}`

Get information about the specified slot

### Parameters

- `account_id: str`

  Customer account tag

- `slot: str`

### Returns

- `class SlotGetResponse: …`

  - `id: str`

    Slot ID

  - `facility: Facility`

    - `address: List[str]`

    - `name: str`

  - `occupied: bool`

    Whether the slot is occupied or not

  - `site: str`

  - `speed: str`

  - `account: Optional[str]`

    Customer account tag

### 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
)
slot = client.network_interconnects.slots.get(
    slot="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
    account_id="account_id",
)
print(slot.id)
```

#### Response

```json
{
  "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
  "facility": {
    "address": [
      "string"
    ],
    "name": "name"
  },
  "occupied": true,
  "site": "site",
  "speed": "speed",
  "account": "account"
}
```

## Domain Types

### Slot List Response

- `class SlotListResponse: …`

  - `items: List[Item]`

    - `id: str`

      Slot ID

    - `facility: ItemFacility`

      - `address: List[str]`

      - `name: str`

    - `occupied: bool`

      Whether the slot is occupied or not

    - `site: str`

    - `speed: str`

    - `account: Optional[str]`

      Customer account tag

  - `next: Optional[int]`

### Slot Get Response

- `class SlotGetResponse: …`

  - `id: str`

    Slot ID

  - `facility: Facility`

    - `address: List[str]`

    - `name: str`

  - `occupied: bool`

    Whether the slot is occupied or not

  - `site: str`

  - `speed: str`

  - `account: Optional[str]`

    Customer account tag