---
title: "GET /v1/displays/"
method: GET
path: "/v1/displays/"
tags: ["Displays"]
---

# GET /v1/displays/

`GET /v1/displays/`

DisplayListView operations.

## Query parameters

- `page` integer
- `page_size` integer

## Response `200`

Success

- PaginatedOptionalDisplaySerializer
  - `total` integer
  - `next` string, nullable
  - `previous` string, nullable
  - `results` OptionalDisplaySerializer[]
    - `id` integer
    - `created_at` string, date-time
    - `name` string
    - `screen_type` 'MONITOR' | 'TABLET' | 'TV' | 'MOBILE'
    - `display_type` 'DEDICATED_SPACE' | 'SPACE_DIRECTORY' | 'FLOORPLAN'
    - `dedicated_space` DisplaySpaceSerializerV1
      - `id` integer
      - `name` string, required
      - `space_type` 'space' | 'floor' | 'building' | 'campus' | 'region' | 'portfolio'
      - `current_count` string
      - `ancestry` string
      - `time_zone` string, nullable
      - `daily_reset` string, nullable
      - `capacity` integer, nullable
      - `target_capacity` integer, nullable
      - `safe_threshold_mode` 'SAFE_CAPACITY' | 'UTILIZATION_PERC_TARGET' | 'UTILIZATION_PERC_LEGAL', nullable
      - `safe_threshold_value` number, nullable
      - `safe_capacity` integer, nullable
    - `dedicated_space_id` integer
    - `space` DisplaySpaceSerializerV1
      - `id` integer
      - `name` string, required
      - `space_type` 'space' | 'floor' | 'building' | 'campus' | 'region' | 'portfolio'
      - `current_count` string
      - `ancestry` string
      - `time_zone` string, nullable
      - `daily_reset` string, nullable
      - `capacity` integer, nullable
      - `target_capacity` integer, nullable
      - `safe_threshold_mode` 'SAFE_CAPACITY' | 'UTILIZATION_PERC_TARGET' | 'UTILIZATION_PERC_LEGAL', nullable
      - `safe_threshold_value` number, nullable
      - `safe_capacity` integer, nullable
    - `space_id` integer
    - `list_spaces` string
    - `list_space_ids` integer[]
    - `sidebar_list_spaces` string
    - `sidebar_list_space_ids` string
    - `token` string
    - `message` string
    - `contact_email` string
    - `display_wait_time` boolean
    - `display_count` boolean
    - `sidebar_mode` 'MESSAGE' | 'LIST_SPACES' | 'NONE'
    - `linked_display_id` integer
    - `linked_display_hash` string
    - `display_trend` boolean
    - `black_and_white_mode` boolean
    - `at_or_above_threshold_text` string
    - `below_threshold_text` string
    - `display_occupancy_metric` boolean
    - `analytics_time` 'TODAY' | 'FIFTEEN_MINUTES' | 'THIRTY_MINUTES' | 'ONE_HOUR' | 'THREE_HOURS' | 'SIX_HOURS' | 'TWELVE_HOURS', nullable

## Other responses

- `403` — Forbidden - Access Denied
- `404` — Not Found

---

[API](https://skmtc.dev/density/apis/your-project-api.md) · [All operations](https://skmtc.dev/density/apis/your-project-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/density/your-project-api/revisions/eab10fe035e6/schema)