---
title: "Returns host availability summary over two and four week windows"
method: GET
path: "/hosts/availability_summary"
tags: ["Hosts"]
---

# Returns host availability summary over two and four week windows

`GET /hosts/availability_summary`

## Request

- Base URL: `https://quads.example.com/api/v3`
- URL: `https://quads.example.com/api/v3/hosts/availability_summary`
- Auth: none declared

## Query parameters

- `now` string, required
- `two_week_start` string, required
- `two_week_end` string, required
- `four_week_end` string, required

## Response `200`

Host availability summary

- Host[]
  - `id` integer
  - `name` string
  - `model` string
  - `host_type` string
  - `build` boolean
  - `validated` boolean
  - `switch_config_applied` boolean
  - `broken` boolean
  - `retired` boolean
  - `can_self_schedule` boolean
  - `overcloud` boolean
  - `rack` string
  - `uloc` string
  - `blade` string
  - `bootmode` string
  - `last_build` string
  - `cloud_id` integer
  - `default_cloud_id` integer
  - `interfaces` Interface[]
    - `id` integer
    - `name` string
    - `bios_id` string
    - `mac_address` string
    - `switch_ip` string
    - `switch_port` string
    - `speed` integer
    - `vendor` string
    - `pxe_boot` boolean
    - `maintenance` boolean
    - `host_id` integer
  - `disks` Disk[]
    - `disk_id` integer
    - `disk_type` string
    - `size_gb` integer
    - `count` integer
    - `host_id` integer
  - `memory` Memory[]
    - `id` integer
    - `size_gb` integer, required
    - `handle` string, required
    - `host_id` integer, required
  - `processors` Processor[]
    - `id` integer
    - `handle` string
    - `vendor` string
    - `product` string
    - `cores` integer
    - `threads` integer
    - `processor_type` string
    - `host_id` integer

## Other responses

- `400`: Bad Request - missing or invalid dates

## Changes

- **2026-09-02** `66987ade4877`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/quadsproject/apis/quads/changes/hosts/availability_summary/get.md)

---

[API](https://skmtc.dev/quadsproject/apis/quads.md) - [All operations](https://skmtc.dev/quadsproject/apis/quads/llms.txt) - [OpenAPI document](https://skmtc.dev/quadsproject/apis/quads/revisions/9d9de833ae79?raw)